EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Метод

Определение

Рассчитывает дату через определенное количество месяцев от указанной даты.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

Параметры

time
DateTime

Объект DateTime, к которому следует добавить параметр months.The DateTime to which to add months.

months
Int32

Добавляемое число месяцев.The number of months to add.

Возвраты

Новый объект DateTime, которые является суммой указанного количества месяцев и параметра time.A new DateTime that results from adding the specified number of months to the time parameter.

Исключения

Полученное значение находится вне допустимого диапазона DateTime.The result is outside the supported range of a DateTime.

months меньше –120 000 или больше 120 000.months is less than -120000 or greater than 120000.

- или --or- Значение time меньше MinSupportedDateTime или больше MaxSupportedDateTime.time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Комментарии

Если итоговый день не является DateTime допустимым днем в результирующем месяце итогового года, то это повлияет на день результата.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. В этом случае часть дня изменяется на последний допустимый день в результирующем месяце итогового года.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. Если итоговый месяц находится за DateTime пределами заданного DateTimeгода, то затронет его часть.The year part of the resulting DateTime is affected if the resulting month is outside the year of the specified DateTime. Эта реализация поддерживает только текущую эру.This implementation supports only the current era. Поэтому вызывается, ArgumentException если полученный год находится за пределами эры указанного DateTime.Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. Время дня в результирующем DateTime наборе остается таким же, как и у указанного. DateTimeThe time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Например, если указанный месяц — Октябрь, который имеет 31 день, указанный день является тридцатым днем этого месяца, а значение months параметра равно 6, то итоговый год будет на единицу больше, чем указанный год, месяц — Апрель, а элемент Итоговый день — это сиртиес день, который является последним днем апреля.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.

Если значение months параметра отрицательное, то результирующий DateTime объект предшествует указанному DateTime.If the value of the months parameter is negative, the resulting DateTime is earlier than the specified DateTime.

Свойство возвращаемого DateTime значения всегда равно DateTimeKind.Unspecified. KindThe Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Kind DateTime.SpecifyKind Свойство параметраможносохранить,вызвавметод,какпоказановследующемпримере.timeYou 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)

Применяется к