timeDiffInHours( )
2つの日付または日時値の時間差を時間単位で計算します。
timeDiffInHours( )ヘルパー・ファンクションは、開始日と終了日がパラメータとして渡された状態で起動されます。この関数は、2つの日付間の差異を示す負または正の数値を時間単位で返します。
時間要素なしで日付型変数を使用する場合、関数は時間を'00:00:00'とみなします。
ノート:
日付ヘルパー関数にパラメータを指定する順序は重要です。結果の戻り値は、最初のパラメータまたは2番目のパラメータとして渡す日付によって異なります。
構文
timeDiffInHours(toDate, fromDate)パラメータ
| パラメータ | 必須/オプション | 説明 |
|---|---|---|
toDate |
必須 | 終了日付の値。 |
fromDate |
必須 | 開始日の値。 |
戻り値
渡された日付間の差異を表す数値(時間数)。この数値は、ポジティブでもネガティブでもかまいません。
- 返される数値が負またはゼロの値の場合、
toDateがfromDateの前または同じであることを意味します。 - ファンクションが正の値を返す場合、
toDateはfromDateの後です。
例)
例3-9 2つの日時アイテムの差異
// Given 2 form questions of type DateTime are defined in the rule as variables:
return timeDiffInHours(dateTime1, dateTime2);例3-10ハードコードされた2つの日時アイテムの違い
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 2つの部分日付アイテム間の差異
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);親トピック: 日時関数