DateTimeOffset.AddYears(Int32) DateTimeOffset.AddYears(Int32) DateTimeOffset.AddYears(Int32) DateTimeOffset.AddYears(Int32) Method

Definition

Gibt ein neues DateTimeOffset-Objekt zurück, das eine angegebene Anzahl von Jahren zum Wert dieser Instanz addiert.Returns a new DateTimeOffset object that adds a specified number of years to the value of this instance.

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 Int32 Int32 Int32

Eine Anzahl von Jahren.A number of years. Die Zahl kann negativ oder positiv sein.The number can be negative or positive.

Gibt zurück

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.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of years represented by years.

Ausnahmen

Der resultierende DateTimeOffset-Wert ist kleiner als MinValue.The resulting DateTimeOffset value is less than MinValue.

- oder --or- Der resultierende DateTimeOffset-Wert ist größer als MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Beispiele

Im USA können die Lizenzen des Treibers nicht für Personen mit weniger als 16 Jahren ausgestellt werden.In the United States, driver's licenses cannot be issued to persons under 16 years of age. Im folgenden Beispiel wird das aktuellste Datum angezeigt, an dem eine Person geboren werden muss, damit die Lizenz eines Treibers gesetzlich ausgestellt werden kann.The following example displays the latest possible date on which a person must be born in order to legally be issued a driver's license.

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);
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 Zeitintervall Einheit (z. b. Minuten AddYears oder Tage) hinzufügen, können Sie keine Bruchteile eines Jahres hinzufügen.Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, AddYears does not enable you to add fractional parts of a year. Verwenden Sie die Add -Methode, um eine Zeit hinzuzufügen, die aus anderen Zeit DateTimeOffset Einheiten zusätzlich zu Jahren zu einem-Objekt besteht.To add a time that consists of other time units in addition to years to a DateTimeOffset object, use the Add method.

Hinweis

Diese Methode gibt ein neues DateTimeOffset -Objekt zurück.This method returns a new DateTimeOffset object. Der Wert des aktuellen-Objekts wird durch Hinzufügen months zu Datum und Uhrzeit nicht geändert.It does not modify the value of the current object by adding months to its date and time.

Gilt für: