Compartir a través de


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Método

Definición

Calcula la fecha equivalente al número especificado de años transcurridos desde la fecha especificada.

public:
 override DateTime AddYears(DateTime time, int years);
public override DateTime AddYears (DateTime time, int years);
override this.AddYears : DateTime * int -> DateTime
Public Overrides Function AddYears (time As DateTime, years As Integer) As DateTime

Parámetros

time
DateTime

Objeto DateTime al que se va a agregar el valor de years.

years
Int32

número de años que se va a sumar.

Devoluciones

Nuevo objeto DateTime que es el resultado de sumar el número especificado de años al parámetro time.

Excepciones

El resultado está fuera del intervalo admitido de un objeto DateTime.

Comentarios

La parte del día del resultado DateTime se ve afectada si el día resultante no es un día válido en el mes resultante del año resultante. En este caso, la parte del día se cambia al último día válido en el mes resultante del año resultante. La parte del mes del resultante DateTime sigue siendo la misma que la especificada DateTime. Esta implementación solo admite la era actual. Por lo tanto, ArgumentException se produce si el año resultante está fuera de la era del especificado DateTime. La parte de hora del día del resultado DateTime sigue siendo la misma que la especificada DateTime.

Por ejemplo, febrero tiene 28 días, excepto durante años bisiestos cuando tiene 29 días. Si la fecha especificada es el veintinueve día de febrero en un año bisiesto y el valor del years parámetro es 1, la fecha resultante será el veintiocho día de febrero en el año siguiente.

Si years es negativo, el resultado DateTime es anterior al especificado DateTime.

La Kind propiedad del valor devuelto DateTime siempre es igual a DateTimeKind.Unspecified. Puede conservar la Kind propiedad del time parámetro llamando al DateTime.SpecifyKind método , como se muestra en el ejemplo siguiente.

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)

Se aplica a