DateTimeOffset.AddYears(Int32) Metodo

Definizione

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di anni al valore di questa istanza.

public:
 DateTimeOffset AddYears(int years);
public DateTimeOffset AddYears(int years);
member this.AddYears : int -> DateTimeOffset
Public Function AddYears (years As Integer) As DateTimeOffset

Parametri

years
Int32

Un certo numero di anni. Il numero può essere negativo o positivo.

Valori restituiti

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'oggetto corrente DateTimeOffset e il numero di anni rappresentati da years.

Eccezioni

Il valore risultante DateTimeOffset è minore di DateTimeOffset.MinValue.

oppure

Il valore risultante DateTimeOffset è maggiore di DateTimeOffset.MaxValue.

Esempio

Nella Stati Uniti, le patenti di guida non possono essere rilasciate a persone di età inferiore a 16 anni. Nell'esempio seguente viene visualizzata la data più recente possibile in cui deve essere nata una persona per poter emettere legalmente una patente di guida.

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)

Commenti

A differenza della maggior parte degli altri metodi che aggiungono una singola unità di intervallo di tempo (ad esempio minuti o giorni) a un valore di data e ora, AddYears non consente di aggiungere parti frazionarie di un anno. Per aggiungere un'ora costituita da altre unità temporali oltre agli anni a un DateTimeOffset oggetto , utilizzare il Add metodo .

Note

Questo metodo restituisce un nuovo DateTimeOffset oggetto. Non modifica il valore dell'oggetto corrente aggiungendo years alla data e all'ora.

Si applica a