EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- 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)