Поделиться через


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.

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

Комментарии

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

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

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

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

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

Применяется к