Date.AddYears

语法

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

关于

返回将 numberOfYears 加上 datetime 值 dateTime 的 date、datetime 或 datetimezone 结果。

• dateTime：向其增加年份值的 date、datetime 或 datetimezone 值。
• numberOfYears：要添加的年数。

示例 1

将 4 年添加到表示日期 2011/5/14 的 date、datetime 或 datetimezone 值。

使用情况

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

输出

#date(2015, 5, 14)

示例 2

将 10 年添加到表示日期 2011/5/14 和时间上午 08:15:22 的 date、datetime 或 datetimezone 值。

使用情况

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

输出

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