Udostępnij za pośrednictwem


EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Metoda

Definicja

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

public:
 override DateTime AddMonths(DateTime time, int months);
public override DateTime AddMonths (DateTime time, int months);
override this.AddMonths : DateTime * int -> DateTime
Public Overrides Function AddMonths (time As DateTime, months As Integer) As DateTime

Parametry

time
DateTime

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

months
Int32

liczba miesięcy do dodania.

Zwraca

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

Wyjątki

Wynik znajduje się poza obsługiwanym zakresem DateTimeelementu .

months jest mniejsza niż -120000 lub większa niż 120000.

-lub-

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ęść roku wynikowego ma wpływ, jeśli wynikowy DateTime miesiąc jest poza rokiem określonego DateTime. 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ść .

Jeśli na przykład określony miesiąc to październik, który ma 31 dni, określony dzień to trzydziesty pierwszy dzień tego miesiąca, a wartość months parametru wynosi 6, wynikowy rok jest większy niż określony rok, wynikowy miesiąc to kwiecień, a wynikowy dzień to trzydziesty dzień, który jest ostatnim dniem w kwietniu.

Jeśli wartość parametru months 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.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

Dotyczy