Compartir vía


EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Método

Definición

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 -> DateTime
Public Overrides Function AddMonths (time As DateTime, months As Integer) As DateTime

Parámetros

time
DateTime

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

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)

Se aplica a