EastAsianLunisolarCalendar.AddYears(DateTime, Int32) 方法

定义

命名空间:

System.Globalization

程序集:

System.Runtime.dll

Source:

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

DateTime，将向其添加 years。

years

Int32

要添加的年数。

返回

DateTime

一个新的 DateTime，通过在 time 参数中添加指定的年数得到。

例外

ArgumentException

结果超出了 DateTime 支持的范围。

ArgumentOutOfRangeException

time 小于 MinSupportedDateTime 或大于 MaxSupportedDateTime。

注解

如果生成的日期不是结果 DateTime 年份的月中的有效日期，则结果的日期部分将受到影响。 在这种情况下，日期部分将更改为结果年份的结果月份中的最后一个有效日期。 生成的 DateTime 的月份部分与指定的 DateTime保持相同。 此实现仅支持当前纪元。 因此， ArgumentException 如果生成的年份在指定 DateTime的纪元之外，则会引发 。 生成的 DateTime 的一天中的时间部分与指定的 DateTime保持相同。

例如，2 月有 28 天，但闰年有 29 天除外。 如果指定的日期是闰年 2 月的第 29 天，并且 参数的 years 值为 1，则生成的日期将是下一年 2 月的第 28 天。

如果 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)