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!)