README
@tmaito/utils
Fast, generic JavaScript/node.js utility functions.
Install
npm i @tmaito/utils
// or
yarn add @tmaito/utils
Usage
import * as Utils from '@tmaito/utils'
// or
import { formatTime, ...} from '@tmaito/utils'
Api 文档
时间格式化 formatTime(timestamp, format)
timestamp
时间戳或者年月日拼接字符串(🌰202002
、20200218
)format
自定义转化格式,默认YYYY-MM-DD
,例如:'YYYY-MM-DD'、'YYYY/MM/DD'、'YYYYMMDD'、'YYYY-MM-DD hh:mm:ss'等
若传入非日期格式,则直接返回该值, 若传入错误的日期格式,则返回
YYYY-MM-DD hh:mm:ss
格式
两个数间的随机数 randomNum(min, max)
- min 最小值
- max 最大值
价格小写转大写 smalltoBig(value)
数字转化百分比 toPercent(value, isTransfer, fixed)
value
值isTransfer
是否需要转化,默认为true
,例如0.13 => 13%
fixed
小数点位数,默认为0
,例如1.2%
金额 千分位转换 toThousands(value, fixed, isFilling)
value
金额fixed
保留fixed
位小数,若不足,则以0
填充,若超出,则四舍五入后的期望位数isFilling
小数位不足时是否填充,默认true
填充 。
一维数组计算之和 sum(arr, key, defaultValue)
arr
一维数组key
需要统计的字段和defaultValue
默认值,可选值
注意## 若
arr
为纯数字数组,则key 置空即可
返回 URL 的参数 getParams(search, key)
search
: 通过location.search
获取的参数字符串key
: 可选值,具体的参数
🌰:
const search = '?name=test&age=31';
getParams(search);
// {
// name: 'test,
// age: '21
// }
getParams(search, name);
// test
// or
const { name, age } = getParams(search);
// name = 'test';
// age = '21';
重置协议头 resetProtocal(url, protocal)
url
: url l链接protocal
: 通过location.protocal
获取当前域名的协议头
🌰:
const search = '?name=test&age=31';
resetProtocal('https://xxx.com', 'http:')
// http://xxx.com
resetProtocal('http://xxx.com', 'https:')
// https://xxx.com
查询参数转成字符串 queryParams2String(queryParams)
queryParams
: queryParams 查询参数
🌰:
const search = '?name=test&age=31';
queryParams2String({
name: 'test',
age: '31'
})
// name=test&age=31
系列精度计算 calculator
截取想要的位数 calculator.strip(num, precision)
返回小数点长度 calculator.digitLength(num)
把小数转成整数,支持科学计数法。如果是小数则放大成整数 calculator.float2Fixed(num)
精确加法 calculator.plus(num, ...)
精确减法 calculator.minus(num, ...)
精确乘法 calculator.times(num, ...)
精确除法 calculator.divide(num, ...)
`calculator.round(num, ratio) 四舍五入
下载文件 download(url)
url
: 下载文件路径
🌰:
download('xxx.xlsx')
文档流方式下载文件 downloadBlob( fileName, content)
fileName
: 文件名content
: 文档流
通过发票代码判断发票类型 getInvoiceType(invoiceCode)
invoiceCode
: 发票代码