EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Método

Definición

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

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.The DateTime to which to add months.

months
Int32

Número de meses que se van a agregar.The number of months to add.

Devoluciones

Nuevo objeto DateTime que es el resultado de sumar el número especificado de meses al parámetro time.A new DateTime that results from adding the specified number of months 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.

months es menor que -120000 o mayor que 120000.months is less than -120000 or greater than 120000.

O bien,-or- time es menor que MinSupportedDateTime o mayor que MaxSupportedDateTime.time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Comentarios

La parte del día del DateTime resultante 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 año del DateTime resultante se ve afectada si el mes resultante está fuera del año del DateTimeespecificado.The year part of the resulting DateTime is affected if the resulting month is outside the year of the specified DateTime. Esta implementación solo admite la era actual.This implementation supports only the current era. Por lo tanto, se produce ArgumentException si el año resultante está fuera de la era del DateTimeespecificado.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 DateTime resultante sigue siendo la misma que la DateTimeespecificada.The time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Por ejemplo, si el mes especificado es octubre, que tiene 31 días, el día especificado es el primer día de ese mes y el valor del parámetro months es 6, el año resultante es uno más que el año especificado, el mes resultante es abril y el día resultante es el día trigésima, que es el último día de abril.For example, if the specified month is October, which has 31 days, the specified day is the thirty-first day of that month, and the value of the months parameter is 6, the resulting year is one more than the specified year, the resulting month is April, and the resulting day is the thirtieth day, which is the last day in April.

Si el valor del parámetro months es negativo, el DateTime resultante es anterior al DateTimeespecificado.If the value of the months parameter is negative, the resulting DateTime is earlier than the specified DateTime.

La propiedad Kind del valor de DateTime devuelto siempre es igual a DateTimeKind.Unspecified.The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Puede conservar la propiedad Kind del parámetro time llamando al método DateTime.SpecifyKind, 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.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

Se aplica a