EastAsianLunisolarCalendar.AddMonths(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ą 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

DateTime

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

Wyjątki

ArgumentException

Wynik znajduje się poza obsługiwanym zakresem .DateTime

ArgumentOutOfRangeException

months wartość 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 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. Wpływ na część roku wynikowej DateTime ma wpływ, jeśli wynikowy miesiąc znajduje się 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ń jest trzydziestym pierwszym dniem tego miesiąca, a wartość months parametru wynosi 6, wynikowy rok jest o jeden więcej niż określony rok, wynikowy miesiąc to kwiecień, a wynikowy dzień to trzydziesty dzień, czyli ostatni dzień 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 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.AddMonths(time, months), time.Kind);

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)