dateDiffInDays( )

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

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

注:

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

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

提示:

语法

dateDiffInDays(toDate, fromDate)

参数

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

返回值

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

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

示例

示例 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!)