Sdílet prostřednictvím


EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Metoda

Definice

Vypočítá datum, které je zadaný počet měsíců od zadaného data.

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

Do DateTime kterého se má přidat months.

months
Int32

Počet měsíců, které se mají přičíst

Návraty

Nový DateTime , který je výsledkem přidání zadaného počtu měsíců do parametru time .

Výjimky

Výsledek je mimo podporovaný rozsah .DateTime

months je menší než -120000 nebo větší než 120000.

-nebo-

time je menší než MinSupportedDateTime nebo větší než MaxSupportedDateTime.

Poznámky

Denní část výsledného DateTime roku je ovlivněna, pokud výsledný den není platným dnem ve výsledném měsíci výsledného roku. V tomto případě se část dne změní na poslední platný den ve výsledném měsíci výsledného roku. Část výsledného roku DateTime je ovlivněna, pokud je výsledný měsíc mimo rok zadaného DateTime. Tato implementace podporuje pouze aktuální éru. Proto je vyvolán, ArgumentException pokud je výsledný rok mimo éru zadaného DateTime. Denní doba výsledné DateTime části zůstává stejná jako zadaná DateTimečást .

Pokud je například zadaný měsíc říjen, který má 31 dní, zadaný den je třicátý první den tohoto měsíce a hodnota parametru months je 6, výsledný rok je o jeden více než zadaný rok, výsledný měsíc je duben a výsledný den je třicátý den, což je poslední den v dubnu.

Pokud je hodnota parametru months záporná, výsledná DateTime hodnota je starší než zadaný DateTimeparametr .

Vlastnost Kind vrácené DateTime hodnoty se vždy rovná DateTimeKind.Unspecified. Vlastnost parametru Kindtime můžete zachovat voláním DateTime.SpecifyKind metody, jak ukazuje následující příklad.

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

Platí pro