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

DateTime,将向其添加 years

years
Int32

要添加的年数。

返回

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

例外

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

注解

如果生成的日期不是结果 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)

适用于