EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> DateTimePublic Overrides Function AddYears (time As DateTime, years As Integer) As DateTimeParámetros
- 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.
time es menor que MinSupportedDateTime o mayor que MaxSupportedDateTime.
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)
