共用方式為

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 年新增至代表 5/14/2011 的 date、datetime 或 datetimezone 值。

使用方式

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

輸出

#date(2015, 5, 14)

範例 2

將 10 年新增至代表 5/14/2011 上午 08:15:22 日期和時間的 date、datetime 或 datetimezone 值。

使用方式

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

輸出

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