years

years(nYears: Number): Period

指定された年数から Period (期間) 値を作成します。

この関数では、period 関数を入力値に適用します。

DataWeave バージョン 2.4.0 で導入されました。

パラメーター

名前説明

名前	説明
`nYears`	年数の整数。正または負の数値が有効です。

nYears

年数の整数。正または負の数値が有効です。

例

次の例では、さまざまな入力での years の動作を示します。 DateTime (日時) 値に 1 年を加算し、整数 4 を Period (期間) 形式の年数 (P4Y) に変換します。 years(-1) + years(2) では月数が返されます。

ソース

%dw 2.0
import * from dw::core::Periods
output application/json
---
{
  nextYear: |2020-10-05T20:22:34.385Z| + years(1),
  fourYearPeriod: years(4),
  addNegativeValue: years(-1) + years(2)
}

出力

{
   "nextYear": "2021-10-05T20:22:34.385Z",
   "fourYearPeriod": "P4Y",
   "addNegativeValue": 12
}