EastAsianLunisolarCalendar.AddYears(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 Jahren entspricht.

public:
 override DateTime AddYears(DateTime time, int years);

public override DateTime AddYears (DateTime time, int years);

override this.AddYears : DateTime * int -> DateTime

Public Overrides Function AddYears (time As DateTime, years As Integer) As DateTime

Parameter

time

DateTime

Die DateTime, der years hinzugefügt werden soll.

years

Int32

Die Anzahl der hinzuzufügenden Jahre

Gibt zurück

DateTime

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

Ausnahmen

ArgumentException

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

ArgumentOutOfRangeException

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

Hinweise

Der Tagesteil des resultierenden DateTime ist betroffen, wenn der sich ergebende 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 Monatsteil des resultierenden DateTime bleibt mit dem angegebenen DateTimeidentisch. Diese Implementierung unterstützt nur die aktuelle Ära. Daher wird ausgelöst, ArgumentException wenn das resultierende Jahr außerhalb der Ära des angegebenen DateTimeliegt. Der Tageszeitteil des resultierenden DateTime bleibt mit dem angegebenen DateTimeidentisch.

Der Februar hat beispielsweise 28 Tage, außer in Schaltjahren, wenn er 29 Tage hat. Wenn das angegebene Datum der neunundzwanzigste Tag des Februars in einem Schaltjahr ist und der Wert des years Parameters 1 ist, ist das resultierende Datum der achtundzwanzigste Tag des Februars im folgenden Jahr.

Wenn years negativ ist, ist das Ergebnis DateTime früher als der angegebene DateTime.

Die Kind Eigenschaft des zurückgegebenen DateTime Werts DateTimeKind.Unspecifiedentspricht immer . 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.AddYears(time, years), time.Kind);

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)