5.2.2 • Published 1 year ago
configjs-utilsjs v5.2.2
configjs-utilsjs
介绍
configjs-utilsjs 是纯 js 方法库, 包含:时间转换,数字转换千分符等。
特性
- 纯 js
更新日志
5.2.0
- 优化
- 调整formatTimes(时间转换)方法 的 ts 类型
5.1.0
- 新特性
- 新增isDate(判断日期是否合法)方法
5.0.1
- 优化
- 调整一些方法
5.0.0
- 新特性
- 补充d.ts类型说明文件
- 删除
- 删除 formatMoney 方法
- 删除 generateDateShortcuts 方法
4.5.0
- 优化
- 修改appendLink(body 添加 link 标签)方法参数类型可传数组,同时修改返回值为Promise
- 修改appendScript(body 添加 js 标签)方法参数类型可传数组,同时修改返回值为Promise
4.4.0
- 新特性
- 新增getURLSearchParams(获取网址的参数,该方法调用 WEB API > URLSearchParams 方法)方法
4.3.1
- Bug 修复
- 修复formatThousands(千分符)方法接入的参数非法报错的情况,修复后该方法直接输出非法的参数,只有数字或数字字符串才执行后续方法
4.3.0
- 其他
- 取消 main、other 目录区分,如需要按需引入直接引用对应的文件或者可以选择 babel-plugin-import 等插件
4.2.0
- 新特性
- other 目录新增formatMoneyUppercase(金额大写)方法
- other 目录新增deepCopy(深拷贝)方法
4.1.0
- 新特性
- other 目录新增dictionarySort(字典排序)方法
- other 目录新增dictionaryClassification(字典分类)方法
4.0.0
- 其他
- 新增 other 目录,里边为一些不常用的方法
- 新特性
- other 目录新增 formatRgbToHex 方法
- other 目录新增generateHex(生成HEX类型的随机颜色)方法
- other 目录新增getUrlQuery(获取网址的参数)方法
- other 目录新增isDarkMode(判断设置主题是否为黑暗模式)方法
- other 目录新增isNumber(判断数字是否合法)方法
3.4.0
- 新特性
- 新增formatRound(四舍五入)方法
3.3.0
- 新特性
- 新增moneyUnitConversion(金额的单位转换功能)方法
- 优化
- 修改formatTimes(时间转换)方法的 times 参数的默认值,改为传入非法值则不处理直接输出
3.2.0
- 新特性
- 新增moneyUnitConversion(金额的单位转换功能)方法
- 优化
- 修改formatTimes(时间转换)方法的 times 参数的默认值,改为必填
3.1.1
- 优化
- 修改formatThousands(千分符)方法的 decimalPlaces 参数规则,不填时不进行处理,为 0 时返回整数
- Bug 修复
- 修复formatThousands(千分符)方法出现的四舍五入精度丢失的情况
3.1.0
- 新特性
- 新增compareVersion(版本比较)方法
- 优化
- 修改 代码结构
- 其他
- 改名 formatMoney 方法改名为formatThousands(千分符)
3.0.1
- 新特性
- 新增 generateDateShortcuts 方法
- 新增generateRandomString(生成随机字符串)方法
- 删除
- 删除 formatStringDateTimes 方法,可通过formatTimes(时间转换)方法实现
2.1.4
- 优化
- 修改 千分符的方法,从 number 转 string,解决 number 长度问题
2.1.3
- 优化
- 修改 打包架构,配置按需加载功能
1.1.2
- Bug 修复
- 修复 千分符方法 bug ~ 修复 首字母大写 bug
1.0.9
- 优化
- 修改 formatMoney 方法新增 separators(分隔符) 参数
安装
# npm:
npm i configjs-utilsjs -S引入方法
方式一. 自动按需引入 (推荐)
babel-plugin-import 是一款 babel 插件,它会在编译过程中将 import 的写法自动转换为按需引入的方式。
// 安装插件
npm i babel-plugin-import -D
// 在 babel.config.js 中配置
plugins: [
[
'import',
{
libraryName: 'configjs-utilsjs',
libraryDirectory: 'lib',
camel2DashComponentName: false
},
'configjs-utilsjs'
]
];
// 接着你可以在代码中直接使用
import { formatTimes } from 'configjs-utilsjs';
const time = formatTimes(new Date(), 'yyyy-MM-dd');
console.log(time);方式二. 手动按需引入
import formatTimes from 'configjs-utilsjs/lib/formatTimes';
const time = formatTimes(new Date(), 'yyyy-MM-dd');
console.log(time);方式三. 导入所有
import configjsUtilsjs from 'configjs-utilsjs';
const time = configjsUtilsjs.formatTimes(new Date(), 'yyyy-MM-dd');
console.log(time);文档
appendLink(body 添加 link 标签)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| files | 添加的链接/链接列表 | string / string[] | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 添加结果 | Promise\<unknown> |
appendScript(body 添加 js 标签)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| files | 添加的链接/链接列表 | string / string[] | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 添加结果 | Promise\<unknown> |
capitalize(首字母大写)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value | 需要转换的内容 | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 转换后的字符串 | string |
compareVersion(版本比较)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| v1 | 被比较的版本1 | string | — | — |
| v2 | 被比较的版本2 | string | — | — |
| separators | 版本号分隔符 | string | — | '.' |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 返回值 0: v2 > v1 1:v1 > v2 2: v1 = v2 | 0 / 1 / 2 |
deepCopy(深拷贝)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| data | 被拷贝值 | T | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 拷贝出来的值 | T |
dictionaryClassification(字典分类)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| data | 需要分类的值 | string[] | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 分类后的值 | {propName: string: string[]} |
dictionarySort(字典排序)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| data | 需要排序的值 | string[] | — | — |
| type | 排序类型,0:默认 1:比默认多A-Z值 | 0 / 1 | — | 0 |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 排序后的值 | string[] |
formatMoneyUppercase(金额大写)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| amount | 金额数值 | number | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 大写的金额 | string |
formatRound(四舍五入)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value | 需要四舍五入值 | string / number | — | — |
| decimalPlaces | 数值保留小数位 | number | — | 0 |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 转换后的字符串 | string |
formatThousands(千分符)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value | 需要转千分符的值 | string / number | — | — |
| separators | 千分符号 | string | — | ',' |
| decimalPlaces | 数值保留小数位 | number / undefined | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 转换后的字符串 | string |
formatTimes(时间转换)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| times | 时间 | Date[] / number[] / string[] / Date / number / string | — | — |
| format | 时间转换类型,具体写法看详情 | string | — | 'yyyy-MM-dd hh:mm:ss' |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 转换后的数据 | string[] / string / number[] / number |
generateDateTimes(根据开始结束时间生成连续的时间数组)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| startTime | 开始时间 | Date | — | — |
| endTime | 结束时间 | Date | — | — |
| type | 根据时间中的值来生成数组,具体区别看详情,可选值为'y',\"M\",\"d\" | 'y' / 'M' / 'd' | 'y',\"M\",\"d\" | 'd' |
| format | 时间转换类型,具体写法看详情 | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 转换后的数据 | string[] / Date[] / number[] |
generateHex(生成HEX类型的随机颜色)
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | HEX类型的随机颜色 | string |
generateRandomString(生成随机字符串)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| length | 生成长度 | number | — | 16 |
| chars | 随机值,默认去掉了容易混淆的字符oOLl,9gq,Vv,Uu,I1 | string | — | 'ABCDEFGHJKMNPQRSTWXYZabcdefhijkmnprstwxyz2345678' |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 生成的字符串 | string |
getUnicode(unicode解码工具)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value | 需要解码的值 | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 解后的码 | string |
getUrlQuery(获取网址的参数)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| url | 网址 | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 网址的参数 | { index: string: string / string[] } |
getURLSearchParams(获取网址的参数,该方法调用 WEB API > URLSearchParams 方法)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value | 网址或者网址参数的字符串,如 \"http://localhost:8080?a=1\" 或者 \"?a=1&a=3&a=2\" | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 网址的参数 | { index: string: string / string[] } |
hexToRgb(HEX 转 RGB)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| hex | HEX格式的颜色值 | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | RGB对象 | TReturn |
isDarkMode(判断设置主题是否为黑暗模式)
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 判断结果 | boolean |
isDate(判断日期是否合法)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| val | 参数 | array | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 判断结果 | boolean |
isNumber(判断数字是否合法)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value | 需要判断的值 | any | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 判断结果 | boolean |
moneyUnitConversion(金额的单位转换功能)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| money | 金额 | number | — | — |
| decimal | 保留的小数 | number | — | 0 |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 转换后的金额, 金额单位 | number, string |
rgbToGrayscale(获取 RGB 格式颜色的灰度)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| r | RGB中的R | number | — | — |
| g | RGB中的G | number | — | — |
| b | RGB中的B | number | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 灰度。0-63: 深灰色到黑色,64-127: 暗灰色,128-191: 浅灰色,192-255: 亮灰色到白色 | number |
formatRgbToHex(RGB 转 HEX)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| r | rgb中的r,可选值为0~255 | number | 0~255 | — |
| g | rgb中的g,可选值为0~255 | number | 0~255 | — |
| b | rgb中的b,可选值为0~255 | number | 0~255 | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 格式化后的颜色 | string |
setUnicode(unicode加密工具)
属性 attr
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| str | 需要加密的值 | string | — | — |
返回 return
| 参数 | 说明 | 类型 |
|---|---|---|
| value | 解码后的内容 | string |
formatTimes-foramt 详情说明
| 参数 | 说明 | 范围 |
|---|---|---|
| y | 年 | 1~4 |
| M | 月 | 1~2 |
| d | 日 | 1~2 |
| h | 小时 | 1~2 |
| m | 分 | 1~2 |
| s | 秒 | 1~2 |
| q | 季度 | 1~2 |
| S | 毫秒 | 1 |
| t | 时间戳 | 1 |
| w | 星期 | 1 |
联系方式
- qq 317883224@qq.com
链接
5.2.2
1 year ago
5.2.1
1 year ago
5.2.0
1 year ago
5.1.1
2 years ago
5.1.0
2 years ago
5.0.1
2 years ago
5.0.0
2 years ago
4.5.0
2 years ago
4.4.0
2 years ago
4.3.1
3 years ago
4.1.0
3 years ago
4.3.0
3 years ago
4.2.0
3 years ago
3.4.0
3 years ago
3.4.1
3 years ago
4.0.0
3 years ago
3.3.0
3 years ago
3.2.0
3 years ago
3.1.1
4 years ago
3.1.0
4 years ago
3.0.1
4 years ago
3.0.0
4 years ago
2.1.4
4 years ago
2.1.2
4 years ago
2.1.3
4 years ago
1.1.1
5 years ago
1.1.0
5 years ago
1.0.9
5 years ago
1.0.8
5 years ago
1.0.7
5 years ago
1.1.2
5 years ago
1.0.6
5 years ago
1.0.2
5 years ago
1.0.5
5 years ago
1.0.3
5 years ago
1.0.1
5 years ago