DateTimeOffset.AddYears(Int32) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié d’années à la valeur de cette instance.

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears (int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Paramètres

years

Int32

Nombre d'années. Le nombre peut être négatif ou positif.

Retours

DateTimeOffset

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par l'objet DateTimeOffset actif et du nombre d'années représenté par years.

Exceptions

ArgumentOutOfRangeException

La valeur résultante DateTimeOffset est inférieure à DateTimeOffset.MinValue.

-ou-

La valeur résultante DateTimeOffset est supérieure à DateTimeOffset.MaxValue.

Exemples

Dans le États-Unis, les permis de conduire ne peuvent pas être délivrés aux personnes de moins de 16 ans. L’exemple suivant affiche la date la plus récente possible à laquelle une personne doit être née pour obtenir légalement un permis de conduire.

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)

Remarques

Contrairement à la plupart des autres méthodes qui ajoutent une seule unité d’intervalle de temps (comme des minutes ou des jours) à une valeur de date et d’heure, AddYears ne vous permet pas d’ajouter des parties fractionnaires d’une année. Pour ajouter une heure qui se compose d’autres unités de temps en plus des années à un DateTimeOffset objet, utilisez la Add méthode .

Notes

Cette méthode retourne un nouvel DateTimeOffset objet. Il ne modifie pas la valeur de l’objet actuel en ajoutant years à sa date et heure.