EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Methode

Definition

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

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

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 Monatsteil des resultierenden DateTime bleibt mit dem angegebenen DateTime identisch. Diese Implementierung unterstützt nur den aktuellen Zeitraum. Daher ArgumentException wird ausgelöst, wenn das resultierende Jahr außerhalb des Zeitraumes des angegebenen DateTime liegt. Der Tageszeitteil des resultierenden DateTime bleibt mit dem angegebenen DateTime identisch.

Der Februar hat beispielsweise 28 Tage, mit Ausnahme von Schaltjahren mit 29 Tagen. Wenn das angegebene Datum der 29. Februartag in einem Schaltjahr und der Wert des years Parameters 1 ist, ist das resultierende Datum der 28. Februartag im folgenden Jahr.

Wenn years negativ ist, liegt das resultierende DateTime vor dem angegebenen DateTime .

Die Kind -Eigenschaft des DateTime zurückgegebenen Werts ist immer gleich DateTimeKind.Unspecified . 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)

Gilt für