Compartilhar via


DateTimeOffset.AddYears(Int32) Método

Definição

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

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

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.

Aplica-se a