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

Объект DateTime, к которому следует добавить параметр years.

years

Int32

количество добавляемых лет.

Возвращаемое значение

DateTime

Новый объект DateTime, которые является суммой указанного количества лет и параметра time.

Исключения

ArgumentException

Полученное значение находится вне допустимого диапазона DateTime.

ArgumentOutOfRangeException

Значение time меньше MinSupportedDateTime или больше MaxSupportedDateTime.

Комментарии

Дневная часть результирующего объекта DateTime затрагивается, если результирующий день не является действительным днем в результирующем месяце результирующего года. В этом случае часть дня изменяется на последний действительный день в результирующем месяце результирующего года. Часть месяца в результирующем DateTime объекте остается той же, что и указанная DateTime. Эта реализация поддерживает только текущую эру. Таким образом, возникает, ArgumentException если результирующий год находится за пределами эры указанного DateTime. Временная часть результирующего объекта DateTime остается той же, что и указанная DateTime.

Например, февраль имеет 28 дней, за исключением високосных лет, когда он имеет 29 дней. Если указанная дата — двадцать девятый день февраля в високосном году, а значение years параметра равно 1, итоговой датой будет двадцать восьмой день февраля следующего года.

Если years является отрицательным, результирующий результат DateTime будет раньше указанного DateTime.

Свойство Kind возвращаемого DateTime значения всегда равно DateTimeKind.Unspecified. Свойство time параметра можно сохранитьKind, вызвав DateTime.SpecifyKind метод , как показано в следующем примере.

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

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