Udostępnij za pośrednictwem


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metoda

Definicja

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

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

Wyjątki

Wynik znajduje się poza obsługiwanym zakresem .DateTime

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

Uwagi

Część dnia wynikowego DateTime wpływa, 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 DateTimeKind.Unspecifiedrówna . 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)

Dotyczy