DateTimeOffset.AddYears(Int32) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

DateTimeOffset.cs

Devuelve un nuevo objeto DateTimeOffset, que agrega un número especificado de años al valor de esta instancia.

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

Número de años. El número puede ser positivo o negativo.

Devoluciones

DateTimeOffset

Objeto cuyo valor es la suma de la fecha y hora representadas por el objeto DateTimeOffset actual y el número de años representados por years.

Excepciones

ArgumentOutOfRangeException

El valor resultante DateTimeOffset es menor que DateTimeOffset.MinValue.

O bien

El valor resultante DateTimeOffset es mayor que DateTimeOffset.MaxValue.

Ejemplos

En el Estados Unidos, las licencias de conducir no se pueden emitir a personas menores de 16 años de edad. En el ejemplo siguiente se muestra la fecha más reciente posible en la que debe nacer una persona para que se emita legalmente una licencia de conducir.

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)

Comentarios

A diferencia de la mayoría de los otros métodos que agregan una sola unidad de intervalo de tiempo (como minutos o días) a un valor de fecha y hora, AddYears no permite agregar partes fraccionarias de un año. Para agregar una hora que consta de otras unidades de tiempo además de años a un DateTimeOffset objeto , use el Add método .

Nota:

Este método devuelve un nuevo DateTimeOffset objeto . No modifica el valor del objeto actual agregando years a su fecha y hora.