timeDiffInHours( )

2つの日付または日時値の時間差を時間単位で計算します。

ノート:

時間要素なしで日付型変数を使用する場合、関数は時間を'00:00:00'とみなします。

timeDiffInHours( )ヘルパー・ファンクションは、パラメータとして渡されるtoDateおよびfromDateを使用して呼び出されます。この関数は、2つの日付の差異を時間数で示す負または正の数値を返します。返される数値が負またはゼロの値の場合、toDateはfromDateの前または同じです。関数が正の値を返す場合、toDateはfromDateの後です。

構文

timeDiffInHours(toDate, fromDate)

パラメータ

toDate

将来の日付または日時の値。

fromDate

開始日または日時の値。

戻り値

日付または日時(時間数)の差異。この数値は正または負にできます。

注意:

日付ヘルパー関数にパラメータを指定する順序は重要です。結果の戻り値は、最初のパラメータまたは2番目のパラメータとして渡す日付によって異なります。

例3-8 2つの日時アイテムの違い

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

例3-9ハードコードされた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-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 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);