閱讀英文

共用方式為


Date.AddYears

語法

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

關於

傳回將 date 新增到 datetimedatetimezonenumberOfYearsdatetimedateTime 結果。

  • dateTime:要新增年份的 datedatetimedatetimezone 值。
  • numberOfYears:要新增的年數。

範例 1

將 4 年新增至代表 5/14/2011 的 datedatetimedatetimezone 值。

使用方式

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

輸出

#date(2015, 5, 14)

範例 2

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

使用方式

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

輸出

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