跳到主要内容

Date.AddYears

将指定年份数添加到该日期。

Syntax​

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

Remarks​

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

  • dateTime: 要将年份数添加到其中的 date、datetime 或 datetimezone 值。
  • numberOfYears: 要添加的年份数。

Examples​

Example #1​

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

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

Result:

#date(2015, 5, 14)

Example #2​

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

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

Result:

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

Category​

Date