dateDiffInDays( )

日数で測定された2つの日付間の日付差異を計算します。

注意:

この関数は、時間要素を含んでおらず日付の一部を含まない日付型の変数を比較する場合にのみ使用されます。日付/時間タイプ・パラメータを使用する場合、関数では日付部分のみが考慮され、時間要素は無視されます。

timeDiffInMinutes( )ヘルパー関数を使用すると、2つの日時項目を比較できます。

日付の質問に部分的な日付要素が含まれている場合は、getDatesCompareResult( )ヘルパー関数を使用します。

dateDiffInDays( )ヘルパー関数は、パラメータとして渡されたtoDateおよびfromDateを使用して呼び出されます。この関数は、2つの日付の差を日数で示す負または正の数値を返します。

返される数値が負の値またはゼロ値の場合、toDateはfromDateの前か同じです。ファンクションが正の値を返す場合、toDateはfromDateより後です。

構文

dateDiffInDays(toDate, fromDate)

パラメータ

toDate

日付値。

fromDate

日付値。

戻り値

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

注意:

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

例3-6 2つの日付アイテムの違い

// Given 2 form questions of type DateTime are defined in the rule as variables:
return dateDiffInDays(datetem1, dateItem2);

例3-7ハードコードされた2つの日付の違い

var toDate = new Date("March 1, 2020");
var fromDate = new Date("March 1, 2019");
return dateDiffInDays(toDate, fromDate);
 
// Returns value: 366 (leap year!)