calculateDateDifference¶
计算两个日期之间的差值,并以秒,分钟,小时和天的形式返回结果。
参数¶
输入参数为一个 JSON 结构体。
参数 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
startDate | 必需 | String | 开始日期和时间。 |
endDate | 必需 | String | 结束日期和时间。 |
startDatePattern | 必需 | String | startDate 参数的字符串格式(例如:yyyyMMdd HH:mm:ss.SSS) |
endDatePattern | 必需 | String | endDate 参数的字符串格式(例如:yyyyMMdd HH:mm:ss.SSS) |
返回值¶
返回的 4 个值将组成一个 JSON 结构体。每个值代表相同的日期差,但比例不同,切勿将这些值加在一起。
值 | 数据类型 | 描述 |
---|---|---|
dateDifferenceSeconds | String | 起始日期时间和结束日期时间之间的差,被截断为最接近的整数秒数。 |
dateDifferenceMinutes | String | 起始日期时间和结束日期时间之间的差,被截断为最接近的整数分钟。 |
dateDiffferenceHours | String | 起始日期时间和结束日期时间之间的差,被截断为最接近的小时数。 |
dateDifferenceDays | String | 起始日期时间和结束日期时间之间的差,被截断为最接近的整数天。 |
示例¶
var difference = tools.DateUtil.calculateDateDifference({"startDate" : "2021-03-09", "endDate" : "2021-03-10", "startDatePattern" : "yyyy-MM-dd", "endDatePattern" : "yyyy-MM-dd"});
return tools.resultBuilder.build(true, JSON.stringify(difference));
输出
"{\"dateDifferenceSeconds\":86400,\"dateDifferenceMinutes\":1440,\"dateDifferenceDays\":1,\"dateDiffferenceHours\":24}"