自定义工具库

安装使用说明

npm install tin-custom-utils --save  // 安装工具包
impore { dayOfYear} from "tin-custom-utils" // 引入工具包
const dayNum = dayOfYear('2023-01-01') // dayNum = 1

date 类方法

1. dayOfYear(date) —— 获取输入日期时间年第几天，不传默认当天 npm deprecate

2. formatDateTime(date,type) —— 返回固定格式的日期，如果不传默认当前日期 2023-09-29 15:00:00

   date: '日期' type 格式有：y-m-d h:m:s | y/m/d h:m:s | y-m-d h:m | y.m.d h:m | m.d | d | h:m formatDateTime('2023-09-09 12:00:00','y/m/d h:m:s') => '2023/09/09 12:00:00'

3. formatNumber(n: number | string) —— 格式化数字，2 位是否补 0

4. getStayTimeStr(startTime?: number | string, endTime?: number | string): Object —— 计算两个时间差(天、时、分、秒)

5. getPassedTime(startTime: number): string —— 格式化时间: 一分钟内>刚刚; 一小时内>xx 分钟前; 1-24 小时内>xx 小时前; 昨天发起>昨天 时:分; 前天发起>前天 时:分; 超过前天>年-月-日 时:分

number 类方法

6. approximatelyEqual(num1: number, num2: number, epsilon?: number): boolean —— 判断两个数字是否近似相等

   num1: 数值 1 num2: 数值 2 epsilon： 精度 approximatelyEqual( 3.1415, 3.14, 0.01 ) // true > approximatelyEqual(3.15, 3.14, 0.01 ) // false > approximatelyEqual( 3.14, 3.16, 0.01 ) // false

7. RandomNum(min: number, max: number): number —— 生成一个(min,max)范围内的随机数
8. average(...nums: number[]): number —— 计算两个或多个数的平均数
9. distance(pointA: TPoint, pointB: TPoint): number —— 计算两点之间的距离

   pointA = (x: 3,y:4）pointB = (x:0,y:0) 例： distance(pointA,pointB) // 5

10. thousandNum(num: string) —— 格式化金钱"20,190,214"
11. randomId = (n = 8): string —— 生成 n 位随机字符串
12. randomColor = (): string —— 生成随机 HEX 色值(#FFFFFF)
13. startScore = (rate: number): string —— 生成星级评分‘★★★☆☆’
14. isValidJSON = (str: string): boolean —— 判断给定的字符串是否是 JSON 字符串
15. getBytes(str: string): number —— 求一个字符串的字节长度，假设：一个英文字符占用一个字节，一个中文字符占用两个字节
16. numToCapital(num: number | string | boolean, type: boolean = '') —— 阿拉伯数字转大写, type 为真是钱数大写

    num： 要转换的数字 type: 真为大写钱数，假为大写数字

Array 类方法

17. allEqual(array: Array): boolean —— 判断数组中的元素是否都相等
18. compact(arr: unknown[]) —— 移除数组中值为 false 的元素
19. getValueByProp( array: any[], data: string | number | boolean, prop: string, value: string): T | false —— 根据属性名获取数组中相对应的值

    array：要获取数据的数组 data： 需要对比的数据 prop： 对比的属性名 value： 想要获取的属性名 getValueByProp([{label:'属性1',value：1}，{label:'属性2‘,value：2}],2,'value','label') => '属性2' > getValueByProp([{label:'属性1',value：1}，{label:'属性2‘,value：2}],'属性1,'label' ) => {label:'属性1', value: 1}

20. deepClone(obj: any): any —— 深拷贝数据
21. filteRepeat(arr: T[]) —— 数组去重

regexp 校验类方法

22. getNameRegexp = (min = 1, max = 20) —— 获取名称通用正则表达式,仅支持汉字、数字、大小写字母、下划线
23. checkPlateNumberFormat(plateNo: string) —— 校验车牌号

其他数据处理方法

24. encipherData(data: string, type: EncipherType): string —— 手机号|邮箱|姓名|身份证加密

    EncipherType：'phone | email | name | card' encipherData('15552877777', 'phone') => 155****7777 > encipherData('[email protected]', 'email') => *12645622*****.com > encipherData('派大星', 'name') => *大星 > encipherData('512326199102115645', 'card') => 5123****5645

25. debounce(this: any, func: Function, wait: number, immediate: boolean = false) —— 防抖函数,immediate 为 true 时为立即执行

    this: this 指向 func：需要执行的函数 wait： 几秒后执行函数 immediate： 立即执行：触发事件后函数会立即执行，n 秒内触发事件不会执行功能函数下一次调用，n 秒后再次触发才会再次执行功能函数 非立即执行：触发事件后 n 秒后才执行函数，如果在 n 秒内又触发了事件，则会重新计算函数执行时间。 // 创建一个防抖方法 let fun = this.debounce(function () {console.log(' 触发了:>> ')}, 3000, false) // 执行防抖方法 fun()

26. throttle(this: any, func: Function, wait: number) —— 节流函数 指连续触发事件但是在 n 秒中只执行一次函数。**节流会稀释函数的执行频率。

    this: this 指向 func：需要执行的函数 wait： 几秒后执行函数 // 创建一个节流方法 let fun = this.throttle(function () {console.log(' 触发了:>> ')}, 3000) // 执行节流方法 fun()

27. recursion( data: Array, val: any, arrItem: string = 'key', objItem: string = 'draftdepartment', arrValItem: string = 'title', objValItem: string = 'draftdepartmentName') —— 递归遍历(根据部门 id 获取部门名称)

    data: 遍历的数组 val: 查询要遍历的对象 arrItem: 数组中对应的遍历的属性名 objItem 对象中要遍历的属性名 arrValItem 数组中获取值的属性名 objValItem 对象中获取值的属性名 const arr = [{ label:'html',value:1,children:[{ label:'div',value:3,children:[{ label:'span',value:4 },{ label:'p',value:5 }] }] },{ label:'css',value:2 }] > let form = {id: 0, label:'p'} > recursion(arr,form,'label','label','value','value') > 返回： form = {id: 0, label:'p', id:5}