dateDiffInDays( )
2つの日付間の日付差異を日数で計算します。
dateDiffInDays( )ヘルパー・ファンクションは、パラメータとして渡された開始日と終了日を使用して起動されます。この関数は、2つの日付間の差異を示す負または正の数値を返します。
ノート:
日付ヘルパー関数にパラメータを指定する順序は重要です。結果の戻り値は、最初のパラメータまたは2番目のパラメータとして渡す日付によって異なります。
この関数は、時間要素を含まず、日付の一部を含まない日付型の変数を比較するためにのみ使用されます。日時タイプ・パラメータを使用する場合、関数は日付部分のみを考慮し、時間要素は無視されます。
ヒント:
- timeDiffInMinutes( )ヘルパー関数を使用すると、2つの日時アイテムを比較できます。
- 日付の質問に日付要素の一部が含まれている場合は、getDatesCompareResult( )ヘルパー関数を使用します。
構文
dateDiffInDays(toDate, fromDate)パラメータ
| パラメータ | 必須/オプション | 説明 |
|---|---|---|
toDate |
必須 | 終了日の値。 |
fromDate |
必須 | 開始日の値。 |
戻り値
渡された日付の差異を表す数値(日数)。この数値は、正または負のいずれかです。
- 返される数値の値が負の値またはゼロの値の場合、
toDateはfromDateの前または同じであることを意味します。 - ファンクションが正の値を返す場合、
toDateはfromDateの後になります。
例
例3-7 2つの日付項目の差異
// Given 2 form questions of type DateTime are defined in the rule as variables:
return dateDiffInDays(datetem1, dateItem2);例3-8 2つのハードコードされた日付の差異
var toDate = new Date("March 1, 2020");
var fromDate = new Date("March 1, 2019");
return dateDiffInDays(toDate, fromDate);
// Returns value: 366 (leap year!)親トピック: 日付と時間ファンクション