dateDiffInDays( )

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

调用 dateDiffInDays( ) 帮助程序函数时，会将开始日期和结束日期作为参数传递。该函数返回负数或正数值，指示两个日期之间的天数差异。

注意：

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

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

提示：

• 可以使用 timeDiffInMinutes( ) 帮助函数来比较两个日期和时间项。
• 如果日期问题包含部分日期元素，则使用 getDatesCompareResult( ) 帮助函数。

语法

dateDiffInDays(toDate, fromDate)

参数

参数	必选/可选	说明
toDate	必需	结束日期值。
fromDate	必需	开始日期值。

返回值

表示传入日期之间的天数差异的数字。此数字可以为正，也可以为负。

• 如果返回的数字值是负值或零值，则意味着 toDate 早于或与 fromDate 相同。
• 如果函数返回正值，则 toDate 在 fromDate 之后。

示例

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

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

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

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