EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Метод

Определение

Рассчитывает дату через определенное количество лет от указанной даты.Calculates the date that is the specified number of years away from the specified date.

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.The DateTime to which to add years.

years
Int32

количество добавляемых лет.The number of years to add.

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

DateTime

Новый объект DateTime, которые является суммой указанного количества лет и параметра time.A new DateTime that results from adding the specified number of years to the time parameter.

Исключения

Полученное значение находится вне допустимого диапазона DateTime.The result is outside the supported range of a DateTime.

Значение time меньше MinSupportedDateTime или больше MaxSupportedDateTime.time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Комментарии

DateTimeЕсли итоговый день не является допустимым днем в результирующем месяце итогового года, то это повлияет на день результата.The day part of the resulting DateTime is affected if the resulting day is not a valid day in the resulting month of the resulting year. В этом случае часть дня изменяется на последний допустимый день в результирующем месяце итогового года.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. Часть месяца результата DateTime остается такой же, как и у указанного DateTime .The month part of the resulting DateTime remains the same as the specified DateTime. Эта реализация поддерживает только текущую эру.This implementation supports only the current era. Поэтому вызывается, ArgumentException Если полученный год находится за пределами эры указанного DateTime .Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. Время дня в результирующем наборе DateTime остается таким же, как и у указанного DateTime .The time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Например, Февраль имеет 28 дней, за исключением високосного года, когда в нем 29 дней.For example, February has 28 days, except during leap years when it has 29 days. Если указанная дата является двадцать девятым днем февраля в високосном году, а значение years параметра равно 1, то итоговая дата будет составлять двадцать восьмого дня февраля в следующем году.If the specified date is the twenty-ninth day of February in a leap year and the value of the years parameter is 1, the resulting date will be the twenty-eighth day of February in the following year.

Если years имеет отрицательное значение, результирующее значение DateTime предшествует указанному DateTime .If years is negative, the resulting DateTime is earlier than the specified DateTime.

KindСвойство возвращаемого DateTime значения всегда равно DateTimeKind.Unspecified .The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Свойство параметра можно сохранить, Kind time вызвав DateTime.SpecifyKind метод, как показано в следующем примере.You can preserve the Kind property of the time parameter by calling the DateTime.SpecifyKind method, as the following example shows.

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

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