DateTimeOffset.AddYears(Int32) Método

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

Devoluções

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

Exceções

Exemplos

Nos Estados Unidos, as cartas de condução não podem ser emitidas a pessoas com menos de 16 anos de idade. O exemplo seguinte mostra a data mais tardia possível em que uma pessoa deve nascer para obter legalmente a carta de condução.

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)

Observações

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