dateDiffInYears( )

2つの日付の間の差異を計算します。たとえば、フォームに「日付」タイプの2つの質問がある場合です。

dateDiffInYears( )ヘルパー・ファンクションは、パラメータとして渡されるtoDateおよびfromDateを使用して呼び出されます。この関数は、2つの日付の差異を示す負または正の数値を年単位で返します。返される数値が負またはゼロの値の場合、toDateはfromDateの前または同じです。関数が正の値を返す場合、toDateはfromDateの後です。

ノート:

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

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

構文

dateDiffInYears(toDate, fromDate)

ノート:

同じ書式の日付を比較する必要があります。

パラメータ

toDate

日付値。

fromDate

日付値。

戻り値

日付の差異(年数)。この数は、プラスでもマイナスでもかまいません。

ノート:

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

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

// Given 2 form questions of type Date (with no time elements) are defined in the rule as variables:
return dateDiffInYears(dateItem1, dateItem2);

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

var toDate = new Date("March 1, 2020");
var fromDate = new Date("March 1, 2000");
return dateDiffInYears(toDate, fromDate);
 
// Returns value: 20