@youngbeen/angle-util
[TOC]
validator
引用
import { validator } from '@youngbeen/angle-util'是否为空白无效字符串（剔除无效的空格之后） isBlankStr
是否为数字 isNumber
是否包含数字 hasNumber
是否为小数 isFloatNum
是否为小写英文字母 isLowercase
是否包含小写英文字母 hasLowercase
是否为大写英文字母 isUppercase
是否包含大写英文字母 hasUppercase
是否为英文或者数字 isNumbersOrLetters
是否为中文字符 isCnCharacter
是否包含中文字符 hasCnCharacter
是否为特殊字符 isSpecialCharacter
是否包含特殊字符 hasSpecialCharacter
是否长度处于 isLengthBetween
是否是名称（只能是中英文） isName
是否是昵称名称（只能是中英文或者数字） isNickName
是否是公司名称（只能是中英文和括号以及部分特殊符号） isCompany
是否是金额（最多2位小数） isAmount
是否是重量（最多3位小数） isWeight
是否是手机号码 isMobileNo
是否是固定电话（区号-号码 格式） isTelephoneNo
是否是传真（仅限数字和-） isFax
是否是微信号(2-20的长度，只能包含英文字母、数字、减号、下划线) isWechatNo
是否是网址 isUrl
是否是银行卡号（限定16-19位） isCardNo
是否是身份证号 isIdCardNo
是否是email地址 isEmailAddress
是否是登录账户（只能包含字母/数字或下划线,且以字母开头） isLoginName
validator.isBlankStr('') // true
validator.isBlankStr('a') // false
validator.isNumber('ab') // false
validator.isNumber('123') // true
validator.hasNumber('123abc') // true
validator.isFloatNum('123.2') // true
validator.isLowercase('abc') // true
validator.hasLowercase('abcDEF') // true
validator.isUppercase('ABC') // true
validator.hasUppercase('abcDEF') // true
validator.isNumbersOrLetters('ABC12') // true
validator.isCnCharacter('ABC') // false
validator.hasCnCharacter('abcDEF我') // true
validator.isSpecialCharacter('ABC') // false
validator.hasSpecialCharacter('abcDEF我') // false
validator.isLengthBetween('ABC12', 2, 5) // true
validator.isName('张三') // true
validator.isNickName('张三12') // true
validator.isCompany('银联商务') // true
validator.isAmount('12.23') // true
validator.isWeight('12.233') // true
validator.isMobileNo('12233334444') // true
validator.isTelephoneNo('027-88483843') // true
validator.isFax('027-88483843') // true
validator.isWechatNo('Youngbeen') // true
validator.isUrl('https://www.abc.com') // true
validator.isCardNo('6273772873772837') // true
validator.isIdCardNo('420222190001019992') // true
validator.isEmailAddress('abc@some.com') // true
validator.isLoginName('abcawef') // true是否是指定长度的数字 isNumberAtLength
validator.isNumberAtLength(string, length)
- string参数必须，代表需要校验的字符串
- length参数必须，代表需要校验的位数
validator.isNumberAtLength('123', 3) // trueanonymizer
引用
import { anonymizer } from '@youngbeen/angle-util'隐私化手机号 fixMobileNo
隐私化电话号码 fixTelNo
隐私化银行卡号 fixCardNo
隐私化身份证号 fixCertNo
隐私化姓名 fixName
anonymizer.fixMobileNo('12311112222') // '123****2222'
anonymizer.fixTelNo('02711112222') // '027****2222'
anonymizer.fixCardNo('6222111122223333') // '622*********3333'
anonymizer.fixCertNo('420000111122223333') // '420000111****23333'
anonymizer.fixName('张三') // '张*'
anonymizer.fixName('张三丰') // '张*丰'
anonymizer.fixName('西门吹雪') // '西**雪'
anonymizer.fixName('张三', true) // '*三'
anonymizer.fixName('张三丰', true) // '*三丰'deviceUtil
引用
import { deviceUtil } from '@youngbeen/angle-util'判断是否是微信 isWechat
deviceUtil.isWechat() // false判断是否是IOS isIOS
deviceUtil.isIOS() // true判断是否是安卓 isAndroid
deviceUtil.isAndroid() // falsedateUtil
引用
import { dateUtil } from '@youngbeen/angle-util'转化秒数为可阅读时间 getReadableTimeBySeconds
getReadableTimeBySeconds(time, {
[seconds: 'yes'|'no'|'dynamic',]
[secondsDynamicLimit: 60]
})- time参数必须，代表待转化的秒数，限定整型
- seconds参数可选，代表秒模式，默认'yes'一直显示秒，'no'不显示秒， 'dynamic'动态显示（时间低于设定值时，显示秒，其他时候不显示秒）
- secondsDynamicLimit参数可选，代表秒动态显示设定值，默认60秒，即默认低于一分钟时则显示秒，其他时候不显示秒（该参数匹配seconds为'dynamic'时生效）
let detail = dateUtil.getReadableTimeBySeconds(23881)
// { days: 0, hours: 6, minutes: 38, seconds: 1, timeString: "6小时38分钟1秒" }
detail = dateUtil.getReadableTimeBySeconds(23881, { seconds: 'no' }))
// { days: 0, hours: 6, minutes: 38, seconds: 1, timeString: "6小时38分钟" }格式化日期时间 formatDateTime
formatDateTime(format, [time])
- format参数必选，指定要格式化为的格式（其中YYYY指代全年份，YY指代缩略年份，MM指代月份，DD指代日，HH指代小时，mm指代分钟，ss指代秒）
- time参数可选，代表待格式化的时间（可接受能转化为js date类型的时间，字符串等），默认使用当前时间
// 假如当前时间是2019-03-15 03:48:50
dateUtil.formatDateTime('YYYYMM') // '201903'
let time = 1452592930000 // 2016-01-12 18:02:10
dateUtil.formatDateTime('MM/DD/YYYY HH:mm', time) // '01/12/2016 18:02'
dateUtil.formatDateTime('YYYY年MM月DD日HH时mm分ss秒', time) // '2016年01月12日18时02分10秒'获取格式化日期时间 getDateTime
getDateTime(time, [type], [seperator])
- time参数必选，代表待格式化的时间（可接受能转化为js date类型的时间，字符串等）
- type参数可选，代表格式化的类型，'short'与's'指代短类型(e.g. 2016-1-12 18:02:10)，'long'与'l'指代长类型(e.g. 2016-01-12 18:02:10)。默认是长类型
- seperator参数可选，代表分隔日期的分隔字符，默认是'-'，用 - 分隔
dateUtil.getDateTime() // ''
let time = 1452592930000
console.log(dateUtil.getDateTime(time)) // '2016-01-12 18:02:10'
console.log(dateUtil.getDateTime(time, 'short', '.')) // '2016.1.12 18:02:10'获取格式化日期 getDate
getDate(time, [type], [seperator])
- time参数必选，代表待格式化的时间（可接受能转化为js date类型的时间，字符串等）
- type参数可选，代表格式化的类型，'short'与's'指代短类型(e.g. 2016-1-12)，'long'与'l'指代长类型(e.g. 2016-01-12)。默认是长类型
- seperator参数可选，代表分隔日期的分隔字符，默认是'-'，用 - 分隔
console.log(dateUtil.getDate()) // ''
let time = 1452592930000
console.log(dateUtil.getDate(time)) // '2016-01-12'
console.log(dateUtil.getDate(time, 'short', '.')) // '2016.1.12'获取格式化时间 getTime
getTime(time, [type])
- time参数必选，代表待格式化的时间（可接受能转化为js date类型的时间，字符串等）
- type参数可选，代表格式化的类型，'short'与's'指代短类型(e.g. 18:02)，'long'与'l'指代长类型(e.g. 18:02:10)。默认是长类型
console.log(dateUtil.getTime()) // ''
let time = 1452592930000
console.log(dateUtil.getTime(time)) // '18:02:10'
console.log(dateUtil.getTime(time, 'short')) // '18:02'numberUtil
引用
import { numberUtil } from '@youngbeen/angle-util'保留n位小数四舍五入 round
round(num, [n])
- num参数必须，代表需要处理的数字
- n参数可选，代表需要保留的小数位，默认为0保留到整数
numberUtil.round(1.23) // 1
numberUtil.round(0.1) // 0
numberUtil.round(-0.1) // 0
numberUtil.round(1.23456, 2) // 1.23
numberUtil.round(1.23456, 3) // 1.235
numberUtil.round(1.2032, 2) // 1.2
numberUtil.round(0.0032, 2) // 0生成随机数 random
random([max], [min])
- max参数可选，代表生成的随机数上限值，包含该值，默认为9
- min参数可选，代表生成的随机数下限值，包含该值，默认为0
numberUtil.random() // 默认生成0~9的随机数（包含0和9）
numberUtil.random(3) // 生成0~3的随机数（包含0和3）
numberUtil.random(3, 1) // 生成1~3的随机数（包含1和3）
numberUtil.random(3, 6) // 传入了错误的下限值，将生成3~3的随机数（即永远返回3）批量生成随机数 multiRandom
multiRandom([count], [max], [min], [isDuplicate])
- count参数可选，代表生成的随机数个数，默认2，生成2个随机数
- max参数可选，代表生成的随机数上限值，包含该值
- min参数可选，代表生成的随机数下限值，包含该值
- isDuplicate参数可选，代表是否生成的随机数可以重复，默认false不可以重复
返回的结果始终是数组
如果生成的随机数不允许重复，那么一定保证生成区间足够生成需求的随机数个数！
// 默认生成2个随机数，生成区间0~9（包含0和9），随机数不重复，例如返回[3, 9]
numberUtil.multiRandom()
// 生成5个随机数，生成区间0~9（包含0和9），随机数不重复，例如返回[3, 9, 0, 2, 8]
numberUtil.multiRandom(5)
// 生成3个随机数，生成区间1~6（包含1和6），随机数不重复，例如返回[3, 1, 5]
numberUtil.multiRandom(3, 6, 1)
// 生成8个随机数，生成区间1~6（包含1和6），随机数可重复，例如返回[3, 1, 5, 2, 3, 6, 2, 5]
numberUtil.multiRandom(8, 6, 1, true)arrayUtil
引用
import { arrayUtil } from '@youngbeen/angle-util'深拷贝 deepCopy
deepCopy(original: any): any
- original参数必须，代表需要深拷贝的内容
let arr = [1, 2, 3]
let newArr = arrayUtil.deepCopy(arr)textUtil
引用
import { textUtil } from '@youngbeen/angle-util'修正电话号码 fixPhoneStr
textUtil.fixPhoneStr('abc123de*4') // '1234'moneyUtil
引用
import { moneyUtil } from '@youngbeen/angle-util'分转元 fenToYuan
// 可接收数字或者字符串
moneyUtil.fenToYuan(100) // '1.00'
moneyUtil.fenToYuan(100.12) // '1.00'
moneyUtil.fenToYuan(125) // '1.25'
moneyUtil.fenToYuan('125') // '1.25'元转分 yuanToFen
// 可接收数字或者字符串
moneyUtil.yuanToFen(100) // '10000'
moneyUtil.yuanToFen(1.12) // '112'
moneyUtil.yuanToFen(1.123) // '112'
moneyUtil.yuanToFen('1.234') // '123'元转万 yuanToWan
// 可接收数字或者字符串，可指定保留多少位小数，默认保留2位
moneyUtil.yuanToWan(100) // '0.01'
moneyUtil.yuanToWan(1.12) // '0.00'
moneyUtil.yuanToWan(12345.4) // '1.23'
moneyUtil.yuanToWan(12345.4, 0) // '1'
moneyUtil.yuanToWan(12345.4, 1) // '1.2'
moneyUtil.yuanToWan('12345.4', 3) // '1.235'金额格式化 moneyStyle
// 可接收数字或者字符串
moneyUtil.moneyStyle(12345) // '12,345'
moneyUtil.moneyStyle(12345.4) // '12,345.4'
moneyUtil.moneyStyle(12345678) // '123,456,789'
moneyUtil.moneyStyle(1.2) // '1.2'
moneyUtil.moneyStyle(1.23) // '1.23'
moneyUtil.moneyStyle(100.12) // '100.12'