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. Свойство параметра можно сохранить Kindtime , вызвав DateTime.SpecifyKind метод , как показано в следующем примере.

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

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