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);