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

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

EastAsianLunisolarCalendar.cs

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

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

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

Исключения

ArgumentException

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

ArgumentOutOfRangeException

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. Свойство параметра можно сохранить Kindtime , вызвав DateTime.SpecifyKind метод , как показано в следующем примере.

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

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