compareDates¶

比较两个日期，并以整数形式返回结果。

参数¶

输入参数为一个 JSON 结构体。

参数	必需/可选	数据类型	描述
startDate	必需	String	开始日期和时间。
endDate	必需	String	结束日期和时间。
startDatePattern	必需	String	`startDate` 参数的字符串格式（例如：yyyyMMdd HH:mm:ss.SSS）
endDatePattern	必需	String	`endDate` 参数的字符串格式（例如：yyyyMMdd HH:mm:ss.SSS）

备注

如果 startDate 是 2021-03-10（startDatePattern 为 yyyy-MM-dd）而 endDate 是 2021-03-10 11:11:55:111（endDatePattern 为 yyyy-MM-dd HH:mm:ss:SSS），该函数将认为开始日期早于结束日期，并将结果返回 -1。更多信息，参见返回值。

返回值 ¶

值	数据类型	描述
Value	Number	检查 `startDate` 是在 `endDate` 之前、之后还是于 `endDate` 同日。 -1：`startDate` 在 `endDate` 之前 0：`startDate` 于 `endDate` 同日 +1：`startDate` 在 `endDate` 之后

示例¶

var difference = tools.DateUtil.compareDates({"startDate" : "2021-03-10", "endDate" : "2021-03-10 11:11:55:111", "startDatePattern" : "yyyy-MM-dd", "endDatePattern" : "yyyy-MM-dd HH:mm:ss:SSS"});
return tools.resultBuilder.build(true, JSON.stringify(difference));

输出

-1