@xilonglab/js-utils

JavaScript 工具函数库，包含数组、日期时间、文件、数字、存储等常用工具函数。

安装

npm install @xilonglab/js-utils

依赖

• lodash: ^4.17.21
• moment: ^2.29.4

使用方式

ES6 模块导入

// 导入整个包
import jsUtils from '@xilonglab/js-utils';

// 使用各个模块
jsUtils.datetime.getToday();
jsUtils.array.forward(arr, index);
jsUtils.number.toFixed(num, 2);
jsUtils.storage.set('key', data);
jsUtils.file.downloadBlob(blob, 'filename.pdf');

// 或者按需导入特定模块
import { datetime, array, number, storage, file } from '@xilonglab/js-utils';

datetime.getToday();
array.forward(arr, index);
number.toFixed(num, 2);
storage.set('key', data);
file.downloadBlob(blob, 'filename.pdf');

模块说明

array.js - 数组操作工具

提供数组元素移动相关的工具函数：

• forward(arr, i): 将数组元素向前移动一位
• backward(arr, i): 将数组元素向后移动一位
• move(arr, oldIndex, newIndex): 将数组元素从旧索引移动到新索引

datetime.js - 日期时间处理工具

基于 moment.js 的日期时间处理工具：

• formatDate(date): 格式化日期
• formatDatetime(date): 格式化日期时间
• getToday(): 获取今天的日期
• getNow(): 获取当前时间
• getNextWeek(): 获取下周的日期
• getHalfYearLater(): 获取半年后的日期
• getOneQuarterLater(): 获取一个季度后的日期
• getTwoQuarterLater(): 获取两个季度后的日期
• getThreeQuarterLater(): 获取三个季度后的日期
• getOneMonthLater() 到 getElevenMonthLater(): 获取 N 个月后的日期
• getMonthLater(n): 获取 N 个月后的日期
• getWeekLater(n): 获取 N 周后的日期
• nDaysLater(dateStr, n): 获取指定日期 N 天后的日期

file.js - 文件下载工具

提供文件下载相关的工具函数：

• downloadBlob(obj, filename): 下载 Blob 对象为文件
• makeBlobUrl(obj): 创建 Blob URL

number.js - 数字处理工具

提供数字处理相关的工具函数：

• random(start, end): 生成指定范围内的随机数
• mean(array): 计算数组的平均值
• sum(array): 计算数组的和
• toFixed(num, s): 四舍六入（奇进偶不进）保留指定小数位
• truncate(num, s): 截取指定小数位
• paddingZero(num, places): 数字补零

storage.js - localStorage 封装工具

提供简化的 localStorage 操作，自动处理 JSON 序列化/反序列化：

• set(key, data): 设置存储值（自动处理对象序列化）
• get(key): 获取存储值（自动处理对象反序列化）

示例

import { datetime, array, number, storage, file } from '@xilonglab/js-utils';

// 日期时间
const today = datetime.getToday();
const nextMonth = datetime.getOneMonthLater();

// 数组操作
const arr = [1, 2, 3, 4, 5];
array.forward(arr, 2); // [1, 3, 2, 4, 5]

// 数字处理
const rounded = number.toFixed(3.14159, 2); // "3.14"
const padded = number.paddingZero(5, 3); // "005"

// 存储
storage.set('user', { name: 'John', age: 30 });
const user = storage.get('user');

// 文件下载
const blob = new Blob(['content'], { type: 'text/plain' });
file.downloadBlob(blob, 'example.txt');

License

ISC