timeDiffInHours( )

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

注意：

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

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

语法

timeDiffInHours(toDate, fromDate)

参数

toDate

将来日期或日期/时间值。

fromDate

开始日期或日期/时间值。

返回值

日期或日期/时间的差异（以小时为单位）（数字）。此数字可以是正数或负数。

注：

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

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

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

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

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

示例 3-10 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 timeDiffInHours(toDate, fromDate);

示例 3-11 两个部分日期项之间的差异

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 timeDiffInHours(toDate, fromDate);