dateDiffInDays( )

计算两个日期之间的日期差(以天为单位)。

注意:

此函数仅用于比较不包含时间元素且不包含部分日期的日期类型的变量。使用日期/时间类型参数时,函数仅考虑日期部分并忽略时间元素。

可以使用 timeDiffInMinutes( ) 帮助函数来比较两个日期和时间项。

如果日期问题包含部分日期元素,则使用 getDatesCompareResult( ) 帮助函数。

使用作为参数传入的 toDatefromDate 来调用 dateDiffInDays( ) 帮助程序函数。该函数返回一个负数或正数值,指示两个日期之间的差异(以天为单位)。

如果返回的数值为负值或零值,则 toDate 早于或等于 fromDate。如果函数返回正值,则 toDatefromDate 之后。

语法

dateDiffInDays(toDate, fromDate)

参数

toDate

日期值。

fromDate

日期值。

返回值

日期之间的差异(天数)。此数字可以为正或负。

注意:

为日期帮助程序函数提供参数的顺序非常重要;生成的返回值取决于作为第一个或第二个参数传递的日期。

示例 3-6 两个日期项之间的差异

// Given 2 form questions of type DateTime are defined in the rule as variables:
return dateDiffInDays(datetem1, dateItem2);

示例 3-7 两个硬编码日期之间的差异

var toDate = new Date("March 1, 2020");
var fromDate = new Date("March 1, 2019");
return dateDiffInDays(toDate, fromDate);
 
// Returns value: 366 (leap year!)