dateDiffInYears( )

计算两个日期（年）之间的差值。例如，如果表单中有两个“日期”类型的问题。

使用作为参数传入的 toDate 和 fromDate 来调用 dateDiffInYears( ) 帮助程序函数。该函数返回一个负数或正数值，指示年中的两个日期之间的差异。如果返回的数值为负值或零值，则 toDate 早于或等于 fromDate。如果函数返回正值，则 toDate 在 fromDate 之后。

注意：

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

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

语法

dateDiffInYears(toDate, fromDate)

注意：

您必须比较格式相同的日期。

参数

toDate

日期值。

fromDate

日期值。

返回值

日期之间的差异（年数）。此数字可以为正或负。

注意：

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

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

// Given 2 form questions of type Date (with no time elements) are defined in the rule as variables:
return dateDiffInYears(dateItem1, dateItem2);

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

var toDate = new Date("March 1, 2020");
var fromDate = new Date("March 1, 2000");
return dateDiffInYears(toDate, fromDate);
 
// Returns value: 20