shared-js-api v0.2.8

Functions

getQueryString(name, href) ⇒ string | Array.<string>

获取 url 查询参数

Kind: global function
Returns: string | Array.<string> - 参数值 value，如果 name 为数组，则返回数组

Example

const href = 'https://www.baidu.com?name=tom&age=20'
getQueryString('name', href) // tom
getQueryString('age', href) // 20
getQueryString(['name', 'age'], href) // ['tom', '20']

fillz(val, count) ⇒ string

内容前补 0

Kind: global function
Returns: string - 补 0 后的值

Example

fillz(1, 1) // '01'

toRawType(val) ⇒ string

获取对象类型

Kind: global function
Returns: string - 类型，Object、String 等

Example

toRawType({}) // Object
toRawType('') // String

isString(val) ⇒ boolean

是否为字符串

Kind: global function
Returns: boolean - 结果

Example

isString('hello') // true

isObject(val) ⇒ boolean

是否为对象

Kind: global function
Returns: boolean - 结果

isArray(val) ⇒ boolean

是否为数组

Kind: global function
Returns: boolean - 结果

isDate(val) ⇒ boolean

是否为日期

Kind: global function
Returns: boolean - 结果

isNumber(val) ⇒ boolean

是否为数字

Kind: global function
Returns: boolean - 结果

isSymbol(val) ⇒ boolean

是否为 Symbol

Kind: global function
Returns: boolean - 结果

isFunction(val) ⇒ boolean

是否为 Function

Kind: global function
Returns: boolean - 结果

isPromise(val) ⇒ boolean

是否为 Promise

Kind: global function
Returns: boolean - 结果

formatDate(val, fmt) ⇒ string

Date 转字符串

Kind: global function
Returns: string - 转换后的日期

Example

formatDate(new Date()) // 2021-02-23
formatDate(new Date(), 'yyyy-MM-dd hh:mm:ss') // 2021-02-23 13:40:44

formatTime(val, fmt) ⇒ string

毫秒转时间

Kind: global function
Returns: string - 转换后的时间

Example

formatTime(60 * 1000) // 00:00:01:00
formatTime(60 * 1000, 'dd 天 hh 小时 mm 分钟 ss 秒') // 00 天 00 小时 01 分钟 00 秒
formatTime(60 * 1000 * 1.5, 'dd 天 hh 小时 mm 分钟 ss 秒') // 00 天 00 小时 01 分钟 30 秒
formatTime(60 * 1000 * 1.5, 'mm 分钟 ss 秒') // 01 分钟 30 秒

toNumber(val) ⇒ *

将字符串转为数字，转换失败返回原参数

Kind: global function
Returns: * - 成功返回数字，失败原样返回

Example

toNumber('1') // 1
toNumber('a') // 'a'

getFirstDateOfMonth(dateConfig) ⇒ string | Date

获取当月第一天

Kind: global function
Returns: string | Date - 结果

Example

// 假设当前为 4 月
getFirstDateOfMonth() // Thu Apr 01 2021 00:00:00 GMT+0800 (中国标准时间)
getFirstDateOfMonth({ fmt: 'yyyy-MM-dd hh:mm:ss' }) // 2021-04-01 00:00:00
getFirstDateOfMonth({ offset: 1, fmt: 'yyyy-MM-dd hh:mm:ss' }) // 2021-05-01 00:00:00

getLastDateOfMonth(dateConfig) ⇒ string | Date

获取当月最后一天

Kind: global function
Returns: string | Date - 结果

Example

// 假设当前为 4 月
getLastDateOfMonth() // Fri Apr 30 2021 23:59:59 GMT+0800 (中国标准时间)
getLastDateOfMonth({ fmt: 'yyyy-MM-dd hh:mm:ss' }) // 2021-04-30 23:59:59
getLastDateOfMonth({ offset: 1, fmt: 'yyyy-MM-dd hh:mm:ss' }) // 2021-05-31 23:59:59

getRangeDateOfMonth(dateConfig) ⇒ Array.<string> | Array.<Date>

获取当月日期范围

Kind: global function
Returns: Array.<string> | Array.<Date> - 结果

Example

// 假设当前为 4 月
getRangeDateOfMonth() // [Thu Apr 01 2021 00:00:00 GMT+0800 (中国标准时间), Fri Apr 30 2021 23:59:59 GMT+0800 (中国标准时间)]
getRangeDateOfMonth({ fmt: 'yyyy-MM-dd hh:mm:ss' }) // ['2021-04-01 00:00:00', '2021-04-30 23:59:59']
getRangeDateOfMonth({ offset: 1, fmt: 'yyyy-MM-dd hh:mm:ss' }) // ['2021-05-01 00:00:00', '2021-05-31 23:59:59']

getRangeDateOfWeek(dateConfig) ⇒ Array.<string> | Array.<Date>

获取当前日期所在周的日期范围，比如今天是 2021 年 4 月 22 日（周 4），那么就返回这周的开始日期和结束日期

Kind: global function
Returns: Array.<string> | Array.<Date> - 结果

Example

getRangeDateOfWeek() // [Mon Apr 19 2021 00:00:00 GMT+0800 (中国标准时间), Sun Apr 25 2021 23:59:59 GMT+0800 (中国标准时间)]
getRangeDateOfWeek({ fmt: 'yyyy-MM-dd hh:mm:ss' }) // ['2021-04-19 00:00:00', '2021-04-25 23:59:59']
getRangeDateOfWeek({ offset: 1, fmt: 'yyyy-MM-dd hh:mm:ss' }) // ['2021-04-26 00:00:00', '2021-05-02 23:59:59']

getSuffix(val, toUpperCase) ⇒ string

获取后缀

Kind: global function
Returns: string - 后缀

Example

getSuffix('xx.jpg') // jpg
getSuffix('xx.jpg', true) // JPG
getSuffix('xx.JPG') // jpg

isEmpty(val) ⇒ boolean

是否为 null、undefined 或者 ''

Kind: global function
Returns: boolean - 结果

Example

isEmpty('') // true
isEmpty(null) // true
isEmpty(undefined) // true
isEmpty(0) // false

encodeHTML(val) ⇒ string

对 html 代码进行编码

Kind: global function
Returns: string - 编码后的字符串

Example

encodeHTML('<div>hello</div>') // &lt;div&gt;hello&lt;/div&gt;

decodeHTML(val) ⇒ string

与 encodeHTML 相反，对字符串进行 html 解码

Kind: global function
Returns: string - 解码后的 html

Example

decodeHTML('&lt;div&gt;hello&lt;/div&gt;') // <div>hello</div>

validate(type, val) ⇒ string

验证参数

Kind: global function
Returns: string - 结果

Example

validate('mobilePhone', '13122222222') // true
validate('mobilePhone', '11111111111') // false

validate('email', '32d@xx.cc') // true
validate('email', '32d.cc') // false