Date.AddYears

構文

Date.AddYears(dateTime as any, numberOfYears as number) as any

バージョン情報

datetime 値 dateTime に numberOfYears を追加した結果の date、datetime、または datetimezone を返します。

• dateTime: 年数の加算先となる date 値、datetime 値、または datetimezone 値。
• numberOfYears: 加算する年数。

例 1

日付 2011 年 5 月 14 日を表す date 値、datetime 値、または datetimezone 値に 4 年を加算します。

使用方法

Date.AddYears(#date(2011, 5, 14), 4)

出力

#date(2015, 5, 14)

例 2

2011 年 5 月 14 日午前 08:15:22 の日付と時刻を表す date 値、datetime 値、または datetimezone 値に 10 年を加算します。

使用方法

Date.AddYears(#datetime(2011, 5, 14, 8, 15, 22), 10)

出力

#datetime(2021, 5, 14, 8, 15, 22)