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 resultante DateTime se ve afectado si el día resultante no es un día válido del 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 del mes del año resultante resultante válido.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. La parte de mes de resultante DateTime sigue siendo el mismo que el especificado DateTime.The month part of the resulting DateTime remains the same as the specified DateTime. Esta implementación admite solo la era actual.This implementation supports only the current era. Por lo tanto, ArgumentException se produce si el año resultante está fuera de la era del elemento especificado DateTime.Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. La parte de hora del día de resultante DateTime sigue siendo el mismo que el especificado DateTime.The time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Por ejemplo, febrero tiene 28 días, excepto en los años bisiestos que 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 en un año bisiesto y el valor de la years del parámetro es 1, la fecha resultante será el día 28 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.

El Kind propiedad devuelto del DateTime valor siempre es igual a DateTimeKind.Unspecified.The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Puede conservar la Kind propiedad de la time parámetro mediante una llamada a la 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