EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

EastAsianLunisolarCalendar.cs

Oblicza datę, która jest określoną liczbą lat od określonej daty.

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

Parametry

time

DateTime

Element DateTime , do którego ma zostać dodany yearselement .

years

Int32

liczba lat do dodania.

Zwraca

DateTime

Nowość DateTime , która wynika z dodania określonej liczby lat do parametru time .

Wyjątki

ArgumentException

Wynik znajduje się poza obsługiwanym zakresem DateTimeelementu .

ArgumentOutOfRangeException

time wartość jest mniejsza niż MinSupportedDateTime lub większa niż MaxSupportedDateTime.

Uwagi

Część dnia wynikowego DateTime ma wpływ, jeśli wynikowy dzień nie jest prawidłowym dniem w wynikowym miesiącu wynikowego roku. W takim przypadku część dnia jest zmieniana na ostatni prawidłowy dzień w wynikowym miesiącu wynikowego roku. Część miesiąca wynikowa DateTime pozostaje taka sama jak określona DateTimewartość . Ta implementacja obsługuje tylko bieżącą erę. W związku z tym jest zgłaszany, ArgumentException jeśli wynikowy rok jest poza erą określonego DateTime. Część czasu dnia wynikowego DateTime pozostaje taka sama jak określona DateTimewartość .

Na przykład luty ma 28 dni, z wyjątkiem lat przestępnych, gdy ma 29 dni. Jeśli określona data to dwudziesty dziewiąty dzień lutego w roku przestępnym, a wartość years parametru wynosi 1, wynikowa data będzie dwudziestym ósmym dniem lutego w następnym roku.

Jeśli years wartość jest ujemna, wynik DateTime jest wcześniejszy niż określony DateTime.

Właściwość Kind zwracanej DateTime wartości zawsze jest równa DateTimeKind.Unspecified. Właściwość parametru time można zachowaćKind, wywołując metodęDateTime.SpecifyKind, jak pokazano w poniższym przykładzie.

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

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