timeDiffInMinutes( )

计算两个日期或日期/时间值之间的时间差（以分钟为单位）。

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

注：

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

使用没有时间元素的日期类型变量时，函数会将时间视为 '00:00:00'。

语法

timeDiffInMinutes(toDate, fromDate)

参数

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

返回值

表示传入日期之间差异（以分钟为单位）的编号。此数字可以为正数或负数。

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

示例

示例 3-13：两个日期/时间项之间的差异

// Given 2 form questions of type DateTime are defined in the rule as variables:
return timeDiffInMinutes(dateTime1, dateTime2);

示例 3-14 两个硬编码的日期/时间项目之间的差异

var toDate = new Date("March 1, 2020 12:02:00");
var fromDate = new Date("March 1, 2020 12:00:00");
return timeDiffInMinutes(toDate, fromDate);
 
// Returns value: 2

示例 3-15 2 个时间项之间的差异

var toDate = new Date( '01-Jan-0001 ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
var fromDate = new Date( '01-Jan-0001 ' + ruleTimeItem2.getHour() + ':' + ruleTimeItem2.getMinute() + ':' + ruleTimeItem2.getSecond() );
return timeDiffInMinutes(toDate, fromDate);

示例 3-16：两个不完整日期项之间的差异

var toDate = new Date( ruleTimeItem.getYear() + '-' +  ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
var fromDate = new Date( ruleTimeItem.getYear() + '-' +  ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
return timeDiffInMinutes(toDate, fromDate);