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