DateTimeOffset.AddYears(Int32) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

DateTimeOffset.cs

Restituisce un nuovo oggetto DateTimeOffset che aggiunge il 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

Numero di anni. Il numero può essere positivo o negativo.

Restituisce

DateTimeOffset

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

Eccezioni

ArgumentOutOfRangeException

Il valore risultante DateTimeOffset è minore di DateTimeOffset.MinValue.

-oppure-

Il valore risultante DateTimeOffset è maggiore di DateTimeOffset.MaxValue.

Esempio

Nella Stati Uniti, le licenze di conducente non possono essere rilasciate a persone di età inferiore ai 16 anni. Nell'esempio seguente viene visualizzata la data più recente possibile in cui deve essere nata una persona per 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 .

Nota

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