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

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

例外

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

注解

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

例如,2 月有 28 天,但当跃年有 29 天时除外。 如果指定日期是 2 月的 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)

适用于