Поделиться через


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

Определение

Рассчитывает дату через определенное количество месяцев от указанной даты.

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.

months
Int32

число добавляемых месяцев.

Возвращаемое значение

Новый объект DateTime, которые является суммой указанного количества месяцев и параметра time.

Исключения

Полученное значение находится вне допустимого диапазона DateTime.

months меньше –120 000 или больше 120 000.

-или-

Значение time меньше MinSupportedDateTime или больше MaxSupportedDateTime.

Комментарии

Дневная часть результирующего объекта DateTime влияет, если результирующий день не является действительным днем в результирующем месяце результирующего года. В этом случае часть дня изменяется на последний действительный день в результирующем месяце результирующего года. Часть года в результирующем DateTime объекте влияет, если результирующий месяц находится за пределами года указанного DateTime. Эта реализация поддерживает только текущую эру. Таким образом, возникает, ArgumentException если результирующий год находится за пределами эры указанного DateTime. Временная часть результирующего объекта DateTime остается той же, что и указанная DateTime.

Например, если указанный месяц — октябрь, имеющий 31 день, указанный день — тридцать первый день этого месяца, а значение months параметра — 6, итоговый год — на один больше указанного года, итоговый месяц — апрель, а итоговый день — тридцатый день, то есть последний день апреля.

Если значение months параметра отрицательное, результат DateTime будет раньше указанного DateTime.

Свойство Kind возвращаемого DateTime значения всегда равно DateTimeKind.Unspecified. Свойство time параметра можно сохранитьKind, вызвав DateTime.SpecifyKind метод , как показано в следующем примере.

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

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