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);
父主题:日期和时间函数