EastAsianLunisolarCalendar.AddMonths(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 meses transcurridos desde la fecha especificada.
public:
override DateTime AddMonths(DateTime time, int months);public override DateTime AddMonths (DateTime time, int months);override this.AddMonths : DateTime * int -> DateTimePublic Overrides Function AddMonths (time As DateTime, months As Integer) As DateTimeParámetros
- months
- Int32
número de meses que se van a agregar.
Devoluciones
Nuevo objeto DateTime que es el resultado de sumar el número especificado de meses al parámetro time.
Excepciones
El resultado está fuera del intervalo admitido de un objeto DateTime.
months es menor que -120000 o mayor que 120000.
O bien
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 año resultante DateTime se ve afectada si el mes resultante está fuera del año del especificado 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, si el mes especificado es octubre, que tiene 31 días, el día especificado es el treinta primer día de ese mes y el valor del months parámetro es 6, el año resultante es uno más del año especificado, el mes resultante es abril y el día resultante es el día treinta, que es el último día de abril.
Si el valor del months parámetro 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.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)
