DateTimeOffset.AddYears(Int32) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

DateTimeOffset.cs

Gibt ein neues DateTimeOffset-Objekt zurück, das eine angegebene Anzahl von Jahren zum Wert dieser Instanz addiert.

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears (int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Parameter

years

Int32

Eine Anzahl von Jahren. Die Zahl kann negativ oder positiv sein.

Gibt zurück

DateTimeOffset

Ein Objekt, dessen Wert die Summe aus der vom aktuellen DateTimeOffset-Objekt dargestellten Datums- und Uhrzeitangabe und der von years dargestellten Anzahl von Jahren ist.

Ausnahmen

ArgumentOutOfRangeException

Der resultierende DateTimeOffset Wert ist kleiner als DateTimeOffset.MinValue.

Oder

Der resultierende DateTimeOffset Wert ist größer als DateTimeOffset.MaxValue.

Beispiele

In der USA können Führerscheine nicht für Personen unter 16 Jahren ausgestellt werden. Das folgende Beispiel zeigt das neueste mögliche Datum an, an dem eine Person geboren werden muss, um legal einen Führerschein ausgestellt zu erhalten.

const int minimumAge = 16;
DateTimeOffset dateToday = DateTimeOffset.Now;
DateTimeOffset latestBirthday = dateToday.AddYears(-1 * minimumAge);
Console.WriteLine("To possess a driver's license, you must have been born on or before {0:d}.",
                  latestBirthday);

let minimumAge = 16
let dateToday = DateTimeOffset.Now
let latestBirthday = dateToday.AddYears(-1 * minimumAge)
printfn $"To possess a driver's license, you must have been born on or before {latestBirthday:d}."

Const minimumAge As Integer = 16
Dim dateToday As DateTimeOffset = DateTimeOffset.Now
Dim latestBirthday As DateTimeOffset = dateToday.AddYears(-1 * minimumAge)
Console.WriteLine("To possess a driver's license, you must have been born on or before {0:d}.", _
                  latestBirthday)

Hinweise

Im Gegensatz zu den meisten anderen Methoden, die einem Datums- und Uhrzeitwert eine einzelne Zeitintervalleinheit (z. B. Minuten oder Tage) hinzufügen, AddYears können Sie keine Bruchteile eines Jahres hinzufügen. Verwenden Sie die Add -Methode, um einem Objekt eine DateTimeOffset Zeit hinzuzufügen, die zusätzlich zu Jahren aus anderen Zeiteinheiten besteht.

Hinweis

Diese Methode gibt ein neues DateTimeOffset Objekt zurück. Der Wert des aktuellen Objekts wird nicht geändert, indem datum und uhrzeit hinzugefügt years werden.