5.1.1 • Published 6 months ago

configjs-utilsjs v5.1.1

Weekly downloads
8
License
ISC
Repository
github
Last release
6 months ago

configjs-utilsjs

介绍

configjs-utilsjs 是纯 js 方法库, 包含:时间转换,数字转换千分符等。

特性

  • 纯 js

更新日志

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

4.1.0

4.0.0

  • 其他
    • 新增 other 目录,里边为一些不常用的方法
  • 新特性
    • other 目录新增formatRgbToHex(格式化颜色 RGB 为 HEX)方法
    • other 目录新增generateHex(生成hex类型的随机颜色)方法
    • other 目录新增getUrlQuery(获取网址的参数)方法
    • other 目录新增isDarkMode(判断设置主题是否为黑暗模式)方法
    • other 目录新增isNumber(判断数字是否合法)方法

3.4.0

3.3.0

  • 新特性
  • 优化
    • 修改formatTimes(时间转换)方法的 times 参数的默认值,改为传入非法值则不处理直接输出

3.2.0

  • 新特性
  • 优化
    • 修改formatTimes(时间转换)方法的 times 参数的默认值,改为必填

3.1.1

  • 优化
    • 修改formatThousands(千分符)方法的 decimalPlaces 参数规则,不填时不进行处理,为 0 时返回整数
  • Bug 修复
    • 修复formatThousands(千分符)方法出现的四舍五入精度丢失的情况

3.1.0

  • 新特性
  • 优化
    • 修改 代码结构
  • 其他

3.0.1

  • 新特性
  • 删除
    • 删除 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被比较的版本1string
v2被比较的版本2string
separators版本号分隔符string'.'

返回 return

参数说明类型
value返回值 0: v2 > v1 1:v1 > v2 2: v1 = v20 / 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 / 10

返回 return

参数说明类型
value排序后的值string[]

formatMoneyUppercase(金额大写)

属性 attr

参数说明类型可选值默认值
amount金额数值number

返回 return

参数说明类型
value大写的金额string

formatRgbToHex(格式化颜色 RGB 为 HEX)

属性 attr

参数说明类型可选值默认值
rrgb中的r,可选值为0~255number0~255
grgb中的g,可选值为0~255number0~255
brgb中的b,可选值为0~255number0~255

返回 return

参数说明类型
value格式化后的颜色string

formatRound(四舍五入)

属性 attr

参数说明类型可选值默认值
value需要四舍五入值string / number
decimalPlaces数值保留小数位number0

返回 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

参数说明类型
valuehex类型的随机颜色string

generateRandomString(生成随机字符串)

属性 attr

参数说明类型可选值默认值
length生成长度number16
chars随机值,默认去掉了容易混淆的字符oOLl,9gq,Vv,Uu,I1string'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[] }

isDarkMode(判断设置主题是否为黑暗模式)

返回 return

参数说明类型
value判断结果boolean

isDate(判断日期是否合法)

属性 attr

参数说明类型可选值默认值
val参数array

返回 return

参数说明类型
value判断结果boolean

isNumber(判断数字是否合法)

属性 attr

参数说明类型可选值默认值
value需要判断的值any

返回 return

参数说明类型
value判断结果boolean

moneyUnitConversion(金额的单位转换功能)

属性 attr

参数说明类型可选值默认值
money金额number
decimal保留的小数number0

返回 return

参数说明类型
value转换后的金额, 金额单位number, string

setUnicode(unicode加密工具)

属性 attr

参数说明类型可选值默认值
str需要加密的值string

返回 return

参数说明类型
value解码后的内容string

formatTimes-foramt 详情说明

参数说明范围
y1~4
M1~2
d1~2
h小时1~2
m1~2
s1~2
q季度1~2
S毫秒1
t时间戳1
w星期1

联系方式

  • qq 317883224@qq.com

链接

5.1.1

6 months ago

5.1.0

6 months ago

5.0.1

6 months ago

5.0.0

7 months ago

4.5.0

7 months ago

4.4.0

10 months ago

4.3.1

11 months ago

4.1.0

11 months ago

4.3.0

11 months ago

4.2.0

11 months ago

3.4.0

1 year ago

3.4.1

1 year ago

4.0.0

1 year ago

3.3.0

1 year ago

3.2.0

1 year ago

3.1.1

2 years ago

3.1.0

2 years ago

3.0.1

2 years ago

3.0.0

2 years ago

2.1.4

3 years ago

2.1.2

3 years ago

2.1.3

3 years ago

1.1.1

3 years ago

1.1.0

3 years ago

1.0.9

3 years ago

1.0.8

3 years ago

1.0.7

3 years ago

1.1.2

3 years ago

1.0.6

3 years ago

1.0.2

3 years ago

1.0.5

3 years ago

1.0.3

3 years ago

1.0.1

3 years ago