timeDiffInHours( )
计算两个日期或日期/时间值之间的时间差（以小时为单位）。
调用 timeDiffInHours( ) 帮助程序函数时，会将开始日期和结束日期作为参数传递。该函数返回负数或正数值，指示两个日期之间的差值（以小时为单位）。
使用没有时间元素的日期类型变量时，函数会将时间视为“00:00:00”。
注意：
为日期帮助程序函数提供参数的顺序非常重要；生成的返回值取决于作为第一个或第二个参数传递的日期。
语法
timeDiffInHours(toDate, fromDate)参数
| 参数 | 必选/可选 | 说明 |
|---|---|---|
toDate |
必需 | 结束日期值。 |
fromDate |
必需 | 开始日期值。 |
返回值
表示传入日期之间以小时为单位的差值的数字。此数字可以为正，也可以为负。
- 如果返回的数字值是负值或零值，则意味着
toDate早于或与fromDate相同。 - 如果函数返回正值，则
toDate在fromDate之后。
示例
示例 3-9 两个日期/时间项之间的差异
// Given 2 form questions of type DateTime are defined in the rule as variables:
return timeDiffInHours(dateTime1, dateTime2);示例 3-10 两个硬编码日期/时间项之间的差异
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-11 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-12 两个部分日期项之间的差异
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);父主题：日期和时间函数