EastAsianLunisolarCalendar.AddYears(DateTime, Int32) 方法

定義

命名空間:

System.Globalization

組件:

System.Runtime.dll

來源:

EastAsianLunisolarCalendar.cs

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

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

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

例外狀況

ArgumentException

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

ArgumentOutOfRangeException

time 小於 MinSupportedDateTime 或大於 MaxSupportedDateTime。

備註

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

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

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

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

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

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