timeDiffInMinutes( )
2つの日付値または日時値の時間差を分単位で計算します。
注意:
時間要素なしで日付型変数を使用する場合、関数は時間を'00:00:00'とみなします。timeDiffInMinutes( )ヘルパー関数は、パラメータとして渡されたtoDateおよびfromDateを使用して呼び出されます。この関数は、2つの日付の差分を分単位で示す負または正の数値を返します。返される数値が負の値またはゼロ値の場合、toDateはfromDateの前か同じです。ファンクションが正の値を返す場合、toDateはfromDateより後です。
構文
timeDiffInMinutes(toDate, fromDate)
戻り値
日付または日時間の差異(分数)。この数値は正または負です。
注意:
日付ヘルパー関数にパラメータを指定する順序は重要です。結果の戻り値は、最初のパラメータまたは2番目のパラメータとして渡す日付によって異なります。
例3-12 2つの日時アイテムの違い
// Given 2 form questions of type DateTime are defined in the rule as variables:
return timeDiffInMinutes(dateTime1, dateTime2);
例3-13ハードコードされた2つの日時アイテムの違い
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-14 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-15 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 timeDiffInMinutes(toDate, fromDate);
親トピック: 日時関数