EastAsianLunisolarCalendar.AddYears(DateTime, Int32) EastAsianLunisolarCalendar.AddYears(DateTime, Int32) EastAsianLunisolarCalendar.AddYears(DateTime, Int32) EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Method

Definición

Calcula la fecha equivalente al número especificado de años transcurridos desde la fecha especificada.Calculates the date that is the specified number of years away from the specified date.

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 DateTime DateTime DateTime

Objeto DateTime al que se va a agregar el valor de years.The DateTime to which to add years.

years
Int32 Int32 Int32 Int32

Número de años que se van a agregar.The number of years to add.

Devoluciones

Nuevo objeto DateTime que es el resultado de sumar el número especificado de años al parámetro time.A new DateTime that results from adding the specified number of years to the time parameter.

Excepciones

El resultado está fuera del intervalo admitido de un objeto DateTime.The result is outside the supported range of a 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.The day part of the resulting DateTime is affected if the resulting day is not a valid day in the resulting month of the resulting year. En este caso, la parte del día se cambia al último día válido en el mes resultante del año resultante.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. La parte del mes del resultante DateTime sigue siendo la misma que la DateTimeespecificada.The month part of the resulting DateTime remains the same as the specified DateTime. Esta implementación solo admite la era actual.This implementation supports only the current era. Por lo ArgumentException tanto, se produce si el año resultante está fuera de la era DateTimedel especificado.Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. La parte de la hora del día del resultado DateTime permanece igual a la especificada. DateTimeThe time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Por ejemplo, febrero tiene 28 días, excepto durante años bisiestos cuando tiene 29 días.For example, February has 28 days, except during leap years when it has 29 days. Si la fecha especificada es el día vigésimo noveno de febrero de un año bisiesto y el valor del years parámetro es 1, la fecha resultante será el día de febrero de febrero del año siguiente.If the specified date is the twenty-ninth day of February in a leap year and the value of the years parameter is 1, the resulting date will be the twenty-eighth day of February in the following year.

Si years es negativo, el resultado DateTime es anterior a la especificada DateTime.If years is negative, the resulting DateTime is earlier than the specified DateTime.

La Kind propiedad del valor devuelto DateTime siempre es igual DateTimeKind.Unspecifieda.The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Puede conservar la Kind propiedad time del parámetro llamando al DateTime.SpecifyKind método, como se muestra en el ejemplo siguiente.You can preserve the Kind property of the time parameter by calling the DateTime.SpecifyKind method, as the following example shows.

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

Se aplica a