Functions

isDate(value) ⇒ boolean

检查 value 是否是 Date 对象。

parseTime(value) ⇒ Object

解析字符串时间

genDate(option) ⇒ Date

根据指定的自选参数，生成日期对象

该方法的参数一般可使用 parseTime 进行得到。

betweenDate(businessTime, [now]) ⇒ boolean

检测当前时间是否在指定时间范围内（毫秒级对比，一般用于检测当前时间是否在店铺营业时间范围内）

dateformat([dateInfo], [format]) ⇒ string

格式化日期信息为指定格式

times(ms, [all], [unit])

将毫秒转化为相应的时间字符串

isDate(value) ⇒ boolean

检查 value 是否是 Date 对象。

Kind: global function
Returns: boolean - 如果 value 是一个日期对象，那么返回 true，否则返回 false。

Param	Type	Description
value	*	要检查的值。

parseTime(value) ⇒ Object

解析字符串时间

Kind: global function
Returns: Object - 年，月，日，小时，分钟，秒数

Param	Type	Description
value	String	如：06:00或者06:00:00（同时支持 '2021-02-01 06:00:00' 的完整日期字符串）

Example

parseTime('06:00'); // now at '2021-03-02 16:00'
// => { year:2021, month:3, day:2, hour:6, minute:0, second:0 }

parseTime('2021-03-02 16:00:00');
// => { year:2021, month:3, day:2, hour:16, minute:0, second:0 }

genDate(option) ⇒ Date

根据指定的自选参数，生成日期对象

该方法的参数一般可使用 parseTime 进行得到。

Kind: global function

Param	Type	Description
option		日期时间参数
[option.year]	Number	年
[option.month]	Number	月
[option.day]	Number	日
[option.hour]	Number	小时
[option.minute]	Number	分钟
[option.second]	Number	秒

Example

genDate({year:2021, month:3, day:2, hour:16});
// => Date

betweenDate(businessTime, [now]) ⇒ boolean

检测当前时间是否在指定时间范围内（毫秒级对比，一般用于检测当前时间是否在店铺营业时间范围内）

Kind: global function

Param	Type	Default	Description
businessTime	String | Array.<String>		指定时间范围（如 '00:00~23:59'）
[now]	Number | Date	Date.now()	待检测目标时间（默认取当前时间）

Example

betweenDate('08:08:59~23:08:59');
// => true // now at '10:08:59'

dateformat([dateInfo], [format]) ⇒ string

格式化日期信息为指定格式

Kind: global function

Param	Type	Default	Description
[dateInfo]	String | Number | Date		日期数据信息
[format]	String	'YYYY-MM-DD'	目标格式（默认：'YYYY-MM-DD'，其它：'HH:mm:ss'），具体参考format (opens new window)

Example

dateformat('2021/02/20 08:08:59');
// => 2021-02-20

dateformat('2021/02/20 08:08:59', 'YYYY-MM-DD HH:mm:ss');
// => 2021-02-20 08:08:59

dateformat(1611961835705, 'YYYY-MM-DD HH:mm:ss');
// => 2021-01-30 07:10:35

times(ms, [all], [unit])

将毫秒转化为相应的时间字符串

Kind: global function

Param	Type	Default	Description
ms	Number		毫秒数
[all]	Boolean	true	是否输出所有符合条件的数值（若为 false，则只取按“天>小时>分钟>秒”的优先级显示后缀）
[unit]	Object	{ day: '天', hour: '小时', minute: '分', second: '秒' }	默认后缀单位

Example

times(9000760);
// => '2小时30分0秒'

times(9000760, false);
// => '3小时'