DateTimeOffset.AddYears(Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een nieuw DateTimeOffset object dat een opgegeven aantal jaren toevoegt aan de waarde van dit exemplaar.
public:
DateTimeOffset AddYears(int years);public DateTimeOffset AddYears(int years);member this.AddYears : int -> DateTimeOffsetPublic Function AddYears (years As Integer) As DateTimeOffsetParameters
- years
- Int32
Een aantal jaren. Het getal kan negatief of positief zijn.
Retouren
Een object waarvan de waarde de som is van de datum en tijd die wordt vertegenwoordigd door het huidige DateTimeOffset object en het aantal jaren dat wordt vertegenwoordigd door years.
Uitzonderingen
De resulterende DateTimeOffset waarde is kleiner dan DateTimeOffset.MinValue.
– of –
De resulterende DateTimeOffset waarde is groter dan DateTimeOffset.MaxValue.
Voorbeelden
In de Verenigde Staten kunnen bestuurderslicenties niet worden verleend aan personen jonger dan 16 jaar. In het volgende voorbeeld ziet u de meest recente datum waarop een persoon moet worden geboren om wettelijk een rijbewijs te kunnen afgegeven.
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)
Opmerkingen
In tegenstelling tot de meeste andere methoden die één tijdsintervaleenheid (zoals minuten of dagen) toevoegen aan een datum- en tijdwaarde, AddYears kunt u geen breukdelen van een jaar toevoegen. Als u een tijd wilt toevoegen die bestaat uit andere tijdseenheden naast jaren aan een DateTimeOffset object, gebruikt u de Add methode.
Note
Met deze methode wordt een nieuw DateTimeOffset object geretourneerd. De waarde van het huidige object wordt niet gewijzigd door deze toe te voegen aan years de datum en tijd.
