共用方式為


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) 方法

定義

計算與指定日期相差指定年份的日期。

public:
 override DateTime AddYears(DateTime time, int years);
public override DateTime AddYears (DateTime time, int years);
override this.AddYears : DateTime * int -> DateTime
Public Overrides Function AddYears (time As DateTime, years As Integer) As DateTime

參數

time
DateTime

要將 years 加入的 DateTime

years
Int32

要新增的年數。

傳回

DateTime,將所指定年份加入至 time 參數所產生。

例外狀況

結果不在 DateTime 支援的範圍內。

備註

如果產生的日期不是結果年份結果月份的有效日期,則產生的 DateTime 日期部分會受到影響。 在此情況下,日期部分會變更為結果年份結果月份的最後一個有效日。 結果 DateTime 的月份部分會維持與指定的 DateTime相同。 此實作僅支援目前的紀元。 因此, ArgumentException 如果產生的年份超出指定的 DateTime紀元,則會擲回 。 結果 DateTime 的當日時間部分會維持與指定的 DateTime相同。

例如,2 月有 28 天,但閏年有 29 天除外。 如果指定的日期是閏年二月的第二十九天,而 參數的值 years 是 1,則產生的日期將會是下一年二月的第二十八天。

如果 years 為負數,則產生的 DateTime 會早於指定的 DateTime

KindDateTime 值的 屬性一律等於 DateTimeKind.Unspecified。 您可以呼叫 DateTime.SpecifyKind 方法來保留 Kind 參數的 time 屬性,如下列範例所示。

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)

適用於