EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metoda

Definicja

Oblicza datę, która jest określoną liczbę lat w odróżnieniu od podanej daty.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

Parametry

time
DateTime

, DateTime Do którego ma zostać dodana years .The DateTime to which to add years.

years
Int32

liczba lat do dodania.The number of years to add.

Zwraca

DateTime

Nowe DateTime wyniki, aby dodać określoną liczbę lat do time parametru.A new DateTime that results from adding the specified number of years to the time parameter.

Wyjątki

Wynik jest spoza obsługiwanego zakresu a DateTime .The result is outside the supported range of a DateTime.

time jest mniejsze niż MinSupportedDateTime lub większe niż MaxSupportedDateTime .time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Uwagi

DateTimeJest to naruszone, jeśli dzień wynikający z tego okresu nie jest prawidłowym dniem w wynikającym z danego miesiąca roku.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. W takim przypadku część Day jest zmieniana na ostatni ważny dzień w ciągu miesiąca w ciągu roku.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. Część miesiąca będąca wynikiem jest taka DateTime sama jak określona DateTime .The month part of the resulting DateTime remains the same as the specified DateTime. Ta implementacja obsługuje tylko bieżącą ERA.This implementation supports only the current era. W związku z tym, ArgumentException jest zgłaszany, jeśli rok wynikający z określonych DateTime .Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. Część godziny wynikająca z wyniku DateTime pozostaje taka sama jak określona DateTime .The time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Na przykład luty ma 28 dni, z wyjątkiem lat przestępnych, gdy ma 29 dni.For example, February has 28 days, except during leap years when it has 29 days. Jeśli określona data jest dwudziestym dziewiątym dniem lutego w roku przestępnym, a wartość years parametru to 1, Data wyniku będzie dwudziesty ósmy dzień lutego w następnym roku.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.

Jeśli years jest ujemna, wynik DateTime jest wcześniejszy niż określony DateTime .If years is negative, the resulting DateTime is earlier than the specified DateTime.

KindWłaściwość zwracanej DateTime wartości zawsze jest równa DateTimeKind.Unspecified .The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Właściwość parametru można zachować Kind time DateTime.SpecifyKind , wywołując metodę, jak pokazano w poniższym przykładzie.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)

Dotyczy