工具函数 Date

Date 类型数据处理工具函数集。

函数列表

函数名	说明	版本
dateGet	获取日期对象	-
dateGetDiffYears	获取两个日期相差的年数	-
dateGetDiffMonths	获取两个日期相差的月数	-
dateGetDiffWeeks	获取两个日期相差的周数	-
dateGetDiffDays	获取两个日期相差的天数	-
dateGetDiffHours	获取两个日期相差的小时数	-
dateGetDiffMinutes	获取两个日期相差的分钟数	-
dateGetDiffSeconds	获取两个日期相差的秒数	-
dateGetDiffMilliSeconds	获取两个日期相差的毫秒数	-
dateGetDiff	获取两个时间的差值	-
dateGetCountdownData	获取两个时间的倒计时数据	-
dateGetCountdownString	获取两个时间的倒计时字符串	-

dateGet

获取日期对象。

参数

参数	说明	类型	默认值	版本
date	日期对象、时间戳、日期字符串	[Date, Number, String]	-	-

返回值

如果传入的参数是一个有效的日期对象、时间戳或日期字符串，则返回该日期的 Date 类型对象，否则返回 null。

dateGetDiffYears

获取两个日期相差的年数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的年数。

dateGetDiffMonths

获取两个日期相差的月数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的月数。

dateGetDiffWeeks

获取两个日期相差的周数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的周数。

dateGetDiffDays

获取两个日期相差的天数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的天数。

dateGetDiffHours

获取两个日期相差的小时数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的小时数。

dateGetDiffMinutes

获取两个日期相差的分钟数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的分钟数。

dateGetDiffSeconds

获取两个日期相差的秒数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的秒数。

dateGetDiffMilliSeconds

获取两个日期相差的毫秒数。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回两个日期相差的毫秒数。

dateGetDiff

获取两个时间的差值。

参数

参数	说明	类型	默认值	版本
startDate	开始日期	[Date, Number, String]	-	-
endDate	结束日期	[Date, Number, String]	-	-

返回值

返回一个对象，对象属性如下：

属性	说明	类型
years	相差的年数	Number
months	相差的月数	Number
weeks	相差的周数	Number
days	相差的天数	Number
hours	相差的小时	Number
minutes	相差的分钟	Number
seconds	相差的秒数	Number
milliSeconds	相差的毫秒数	Number

dateGetCountdownData

获取两个时间的倒计时数据。

提示

相对于当前时间，倒计时结束还有多久

参数

参数	说明	类型	默认值	版本
endDate	结束日期	[Date, Number, String]	-	-
level	要获取的级别，具体查看下方说明	String	day	-

level 参数说明：

• week: 获取倒计时周、天、小时、分钟、秒、毫秒
• day: 获取倒计时天、小时、分钟、秒、毫秒
• hour: 获取倒计时小时、分钟、秒、毫秒
• minute: 获取倒计时分钟、秒、毫秒
• second: 获取倒计时秒、毫秒
• milliSecond: 获取倒计时毫秒

返回值

返回一个对象，对象属性如下：

属性	说明	类型
weeks	剩余周数	Number
days	剩余天数	Number
hours	剩余小时	Number
minutes	剩余分钟	Number
seconds	剩余秒数	Number
milliSeconds	剩余毫秒数	Number

dateGetCountdownString

获取两个时间的倒计时字符串。

提示

相对于当前时间，倒计时结束还有多久

参数

参数	说明	类型	默认值	版本
endDate	结束日期	[Date, Number, String]	-	-
formatString	格式字符串	String	"{DD}天{HH}时{MM}分{SS}秒"	-

formatString 参数说明：

示例：距离倒计时结束还剩{WW}周{DD | D}天{HH | D}时{MM | M}分{SS | S}秒{MSS | MS}毫秒

提示

字母大写，双字母或三字母表示补零，否则不补零。

返回值

返回一个格式化后的倒计时字符串，例如：距离倒计时结束还剩12周02天12时12分12秒120毫秒