EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Method

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 DateTime DateTime DateTime

Objeto DateTime al que se va a agregar el valor de months.The DateTime to which to add months.

months
Int32 Int32 Int32 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 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 del año del resultante DateTime se ve afectado si el mes resultante está fuera del año del elemento especificado DateTime.The year part of the resulting DateTime is affected if the resulting month is outside the year of 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, si el mes especificado es octubre, que tiene 31 días, el día especificado es el 31 días de ese mes y el valor de la months parámetro es 6, el año resultante es uno más del año especificado, el mes resultante será abril y el resultante es el trigésimo día, 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 de la months parámetro es negativo, el resultado DateTime es anterior a la especificada DateTime.If the value of the months parameter 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.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

Se aplica a