timeDiffInSeconds( )

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

timeDiffInSeconds( )ヘルパー・ファンクションは、開始日と終了日がパラメータとして渡された状態で起動されます。この関数は、2つの日付間の差異を示す負または正の数値を秒単位で返します。

注意:

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

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

構文

timeDiffInSeconds(toDate, fromDate)

パラメータ

パラメータ	必須/オプション	説明
toDate	必須	終了日の値。
fromDate	必須	開始日の値。

戻り値

渡された日付間の差異を表す数値(秒)。この数値は、プラスまたはマイナスのいずれかです。

• 返される数値が負またはゼロの値の場合、toDateがfromDateの前または同じであることを意味します。
• ファンクションが正の値を返す場合、toDateはfromDateの後です。

例)

例3-17 2つの日時アイテムの差異

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

例3-18ハードコードされた2つの日時アイテムの違い

var toDate = new Date("March 1, 2020 12:02:00");
var fromDate = new Date("March 1, 2020 12:00:00");
return timeDiffInSeconds(toDate, fromDate);
 
// Returns value: 120

例3-19 2つの時間項目間の差異

var date1 = new Date( '01-Jan-0001 ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
var date2 = new Date( '01-Jan-0001 ' + ruleTimeItem2.getHour() + ':' + ruleTimeItem2.getMinute() + ':' + ruleTimeItem2.getSecond() );
return areDateTimesEqual(date1, date2);

例3-20 2つの部分日付項目の比較

var date1 = new Date( ruleTimeItem.getYear() + '-' +  ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
var date2 = new Date( ruleTimeItem.getYear() + '-' +  ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
return areDateTimesEqual(date1, date2);