Прочитать на английском

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


DateTimeOffset.AddMonths(Int32) Метод

Определение

Возвращает новый объект DateTimeOffset, добавляющий заданное число месяцев к значению данного экземпляра.

public DateTimeOffset AddMonths(int months);

Параметры

months
Int32

Число полных месяцев. Это число может быть положительным или отрицательным.

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

Объект, значение которого равно сумме даты и времени, представленных текущим объектом DateTimeOffset, и количества месяцев, представленных параметром months.

Исключения

Полученное DateTimeOffset значение меньше DateTimeOffset.MinValue.

-или-

Полученное DateTimeOffset значение больше DateTimeOffset.MaxValue.

Примеры

В следующем примере метод используется AddMonths для отображения даты начала каждого квартала 2007 года.

DateTimeOffset quarterDate = new DateTimeOffset(2007, 1, 1, 0, 0, 0,
                                 DateTimeOffset.Now.Offset);
for (int ctr = 1; ctr <= 4; ctr++)
{
   Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate);
   quarterDate = quarterDate.AddMonths(3);
}
// This example produces the following output:
//       Quarter 1: January 1
//       Quarter 2: April 1
//       Quarter 3: July 1
//       Quarter 4: October 1

Комментарии

В отличие от большинства других методов, которые добавляют одну единицу интервала времени (например, минуты или дни) к значению даты и времени, AddMonths не позволяет добавлять дробные части месяца. Чтобы добавить к объекту время, состоящее из других единиц времени в дополнение к месяцам DateTimeOffsetAdd , используйте метод .

Примечание

Этот метод возвращает новый DateTimeOffset объект . Он не изменяет значение текущего объекта путем добавления months к его дате и времени.

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0