DateTimeOffset.AddYears(Int32) Methode

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears(int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Parameter

Gibt zurück

Ein Objekt, dessen Wert die Summe des Datums und der Uhrzeit darstellt, das durch das aktuelle DateTimeOffset Objekt dargestellt wird, und die Anzahl der Jahre, die durch yearsdargestellt werden.

Ausnahmen

Beispiele

Im USA können keine Führerscheine für Personen unter 16 Jahren ausgestellt werden. Im folgenden Beispiel wird das neueste mögliche Datum angezeigt, an dem eine Person geboren werden muss, um rechtlich einen Führerschein ausgestellt zu werden.

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. Wenn Sie eine Zeit hinzufügen möchten, die zusätzlich zu Jahren zu einem DateTimeOffset Objekt aus anderen Zeiteinheiten besteht, verwenden Sie die Add Methode.