EastAsianLunisolarCalendar.AddYears(DateTime, Int32) EastAsianLunisolarCalendar.AddYears(DateTime, Int32) EastAsianLunisolarCalendar.AddYears(DateTime, Int32) EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Method

Определение

Рассчитывает дату через определенное количество лет от указанной даты.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 DateTime DateTime

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

years
Int32 Int32 Int32 Int32

Добавляемое число лет.The number of years to add.

Возвраты

Новый объект 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.

Комментарии

Если итоговый день не является 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 наборе остается таким же, как и у указанного. DateTimeThe 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.

Свойство возвращаемого DateTime значения всегда равно DateTimeKind.Unspecified. KindThe Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Kind DateTime.SpecifyKind Свойство параметраможносохранить,вызвавметод,какпоказановследующемпримере.timeYou 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)

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