EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Methode

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

EastAsianLunisolarCalendar.cs

Berechnet das Datum, das dem angegebenen Zeitintervall zum angegebenen Datum in Monaten entspricht.

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

Parameter

time

DateTime

Die DateTime, der months hinzugefügt werden soll.

months

Int32

Die Anzahl der hinzuzufügenden Monate

Gibt zurück

DateTime

Eine neue DateTime, die sich ergibt, wenn dem time-Parameter die festgelegte Anzahl von Monaten hinzugefügt wird.

Ausnahmen

ArgumentException

Das Ergebnis liegt außerhalb des unterstützten Bereichs von DateTime.

ArgumentOutOfRangeException

months ist kleiner als –120000 oder größer als 120000.

- oder -

time ist kleiner als MinSupportedDateTime oder größer als MaxSupportedDateTime.

Hinweise

Der Tagesteil des resultierenden DateTime ist betroffen, wenn der resultierende Tag kein gültiger Tag im resultierenden Monat des resultierenden Jahres ist. In diesem Fall wird der Tagesteil in den letzten gültigen Tag im resultierenden Monat des resultierenden Jahres geändert. Der Jahresteil des resultierenden DateTime ist betroffen, wenn der resultierende Monat außerhalb des Jahres des angegebenen DateTimeliegt. Diese Implementierung unterstützt nur den aktuellen Zeitraum. Daher wird ausgelöst, ArgumentException wenn das resultierende Jahr außerhalb des Zeitraums des angegebenen DateTimeliegt. Der Tageszeitteil des resultierenden DateTime bleibt identisch mit dem angegebenen DateTime.

Wenn beispielsweise der angegebene Monat Oktober ist, der 31 Tage hat, der angegebene Tag der dreißigste Tag dieses Monats ist und der Wert des months Parameters 6 ist, ist das resultierende Jahr ein Jahr mehr als das angegebene Jahr, der resultierende Monat ist April, und der resultierende Tag ist der dreißigste Tag, der der letzte Tag im April ist.

Wenn der Wert des months Parameters negativ ist, ist das ergebnis DateTime vor dem angegebenen DateTime.

Die Kind -Eigenschaft des zurückgegebenen DateTime Werts ist DateTimeKind.Unspecifiedimmer gleich . Sie können die Kind -Eigenschaft des time Parameters beibehalten, indem Sie die DateTime.SpecifyKind -Methode aufrufen, wie im folgenden Beispiel gezeigt.

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

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