DateTimeOffset.AddYears(Int32) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de anos ao valor dessa instância.

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears (int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Parâmetros

years

Int32

Um número de anos. O número pode ser positivo ou negativo.

Retornos

DateTimeOffset

Um objeto cujo valor é a soma da data e hora representada pelo objeto DateTimeOffset atual e o número de anos representado por years.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é maior que DateTimeOffset.MaxValue.

Exemplos

No Estados Unidos, as carteiras de motorista não podem ser emitidas para pessoas menores de 16 anos. O exemplo a seguir exibe a data mais recente possível na qual uma pessoa deve nascer para receber legalmente uma carteira de motorista.

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)

Comentários

Ao contrário da maioria dos outros métodos que adicionam uma única unidade de intervalo de tempo (como minutos ou dias) a um valor de data e hora, AddYears você não permite adicionar partes fracionárias de um ano. Para adicionar um tempo que consiste em outras unidades temporais além de anos a um DateTimeOffset objeto , use o Add método .

Observação

Este método retorna um novo objeto DateTimeOffset. Ele não modifica o valor do objeto atual adicionando years à sua data e hora.