1. Homepage
  2. DataWeave (2.4)
  3. DataWeave リファレンス
  4. dw::core::Periods

  5. years

years

years(nYears: Number): Period

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

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

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

パラメーター

名前 説明

​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
}