Класс перечисления Month

public static final Month JANUARY

Единственный экземпляр месяца январь, состоящего из 31 дня. Его числовое значение — 1.

public static final Month FEBRUARY

Единственный экземпляр месяца февраль, состоящего из 28 дней или 29 дней в високосном году. Его числовое значение — 2.

public static final Month MARCH

Единственный экземпляр месяца март, состоящего из 31 дня. Его числовое значение — 3.

public static final Month APRIL

Единственный экземпляр месяца апрель, состоящего из 30 дней. Его числовое значение — 4.

public static final Month MAY

Единственный экземпляр месяца май, состоящего из 31 дня. Его числовое значение — 5.

public static final Month JUNE

Единственный экземпляр месяца июнь, состоящего из 30 дней. Его числовое значение — 6.

public static final Month JULY

Единственный экземпляр месяца июль, состоящего из 31 дня. Его числовое значение — 7.

public static final Month AUGUST

Единственный экземпляр месяца август, состоящего из 31 дня. Его числовое значение — 8.

public static final Month SEPTEMBER

Единственный экземпляр месяца сентябрь, состоящего из 30 дней. Его числовое значение — 9.

public static final Month OCTOBER

Единственный экземпляр месяца октябрь, состоящего из 31 дня. Его числовое значение — 10.

public static final Month NOVEMBER

Единственный экземпляр месяца ноябрь, состоящего из 30 дней. Его числовое значение — 11.

public static final Month DECEMBER

Единственный экземпляр месяца декабрь, состоящего из 31 дня. Его числовое значение — 12.

public static Month[] values()

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

public static Month valueOf(String name)

Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Пробельные символы в строке не допускаются.)

public static Month of(int month)

Создает экземпляр Month на основе значения int.

Month — это перечисление, представляющее 12 месяцев года. Этот метод-фабрика позволяет получить значение перечисления на основе значения int. Значение int соответствует стандарту ISO-8601: от 1 (январь) до 12 (декабрь).

public static Month from(TemporalAccessor temporal)

Создает экземпляр Month на основе объекта даты и времени.

Этот метод получает месяц на основе указанного объекта даты и времени. TemporalAccessor представляет произвольный набор сведений о дате и времени, который этот метод-фабрика преобразует в экземпляр Month.

Преобразование извлекает поле MONTH_OF_YEAR. Извлечение разрешено только в том случае, если объект даты и времени использует календарь ISO либо может быть преобразован в LocalDate.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его в качестве запроса посредством ссылки на метод, Month::from.

public int getValue()

Возвращает int значение месяца года.

Нумерация значений соответствует стандарту ISO-8601: от 1 (январь) до 12 (декабрь).

public String getDisplayName(TextStyle style, Locale locale)

Возвращает текстовое представление, например «янв.» или «декабрь».

Возвращает текстовое название, используемое для обозначения месяца года и подходящее для отображения пользователю. Стиль возвращаемого текста и локаль задаются параметрами.

Если текстовое соответствие не найдено, возвращается numeric value.

public boolean isSupported(TemporalField field)

Проверяет, поддерживается ли указанное поле.

Этот метод проверяет, можно ли запросить у этого месяца года значение указанного поля. Если результат равен false, вызовы методов range и get приведут к выбросу исключения.

Если поле — MONTH_OF_YEAR, этот метод возвращает true. Для всех остальных экземпляров ChronoField возвращается false.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.isSupportedBy(TemporalAccessor) с аргументом this. Поддержка поля определяется самим полем.

public ValueRange range(TemporalField field)

Возвращает диапазон допустимых значений указанного поля.

Объект диапазона содержит минимальное и максимальное допустимые значения поля. Этот месяц используется для повышения точности возвращаемого диапазона. Если невозможно вернуть диапазон, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле — MONTH_OF_YEAR, возвращается диапазон месяцев года от 1 до 12. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.rangeRefinedBy(TemporalAccessor) с аргументом this. Возможность получения диапазона определяется самим полем.

public int get(TemporalField field)

Возвращает значение указанного поля для этого месяца года в виде int.

Этот метод запрашивает значение указанного поля для данного месяца. Возвращенное значение всегда находится в допустимом диапазоне значений поля. Если невозможно вернуть значение, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле — MONTH_OF_YEAR, возвращается значение месяца года от 1 до 12. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.getFrom(TemporalAccessor) с аргументом this. Возможность получения значения и его смысл определяются самим полем.

public long getLong(TemporalField field)

Возвращает значение указанного поля для этого месяца года в виде long.

Этот метод запрашивает значение указанного поля для данного месяца. Если невозможно вернуть значение, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле — MONTH_OF_YEAR, возвращается значение месяца года от 1 до 12. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.getFrom(TemporalAccessor) с аргументом this. Возможность получения значения и его смысл определяются самим полем.

public Month plus(long months)

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

При вычислении выполняется переход через конец года — от декабря к январю. Указанный период может быть отрицательным.

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

public Month minus(long months)

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

При вычислении выполняется переход через начало года — от января к декабрю. Указанный период может быть отрицательным.

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

public int length(boolean leapYear)

Возвращает число дней в этом месяце.

Флаг определяет, следует ли возвращать число дней для високосного года.

В феврале 28 дней в обычном году и 29 дней в високосном. В апреле, июне, сентябре и ноябре по 30 дней. Во всех остальных месяцах по 31 дню.

public int minLength()

Возвращает минимальное число дней в этом месяце.

В феврале минимально 28 дней. В апреле, июне, сентябре и ноябре по 30 дней. Во всех остальных месяцах по 31 дню.

public int maxLength()

Возвращает максимальное число дней в этом месяце.

В феврале максимум 29 дней. В апреле, июне, сентябре и ноябре по 30 дней. Во всех остальных месяцах по 31 дню.

public int firstDayOfYear(boolean leapYear)

Возвращает номер первого дня этого месяца в году.

Возвращает день года, с которого начинается этот месяц; флаг високосного года используется для определения числа дней в феврале.

public Month firstMonthOfQuarter()

Возвращает месяц, соответствующий первому месяцу этого квартала.

Год можно разделить на четыре квартала. Этот метод возвращает первый месяц квартала, к которому относится исходный месяц. Для января, февраля и марта возвращается январь. Для апреля, мая и июня возвращается апрель. Для июля, августа и сентября возвращается июль. Для октября, ноября и декабря возвращается октябрь.

public <R> R query(TemporalQuery<R> query)

Выполняет запрос к этому месяцу года с помощью указанного запроса.

Этот метод выполняет запрос к этому месяцу года с помощью указанного объекта стратегии запроса. Объект TemporalQuery определяет логику получения результата. Чтобы понять, каким будет результат этого метода, ознакомьтесь с документацией запроса.

Результат этого метода получается вызовом метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса с аргументом this.

public Temporal adjustInto(Temporal temporal)

Изменяет указанный объект даты и времени так, чтобы он содержал этот месяц года.

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

Изменение эквивалентно вызову Temporal.with(TemporalField, long) с полем ChronoField.MONTH_OF_YEAR. Если указанный объект даты и времени не использует календарную систему ISO, выбрасывается DateTimeException.

В большинстве случаев код будет понятнее, если изменить порядок вызова и использовать Temporal.with(TemporalAdjuster):

  // these two lines are equivalent, but the second approach is recommended
  temporal = thisMonth.adjustInto(temporal);
  temporal = temporal.with(thisMonth);

Например, если дана дата в мае, результат будет следующим:

  dateInMay.with(JANUARY);    // four months earlier
  dateInMay.with(APRIL);      // one months earlier
  dateInMay.with(MAY);        // same date
  dateInMay.with(JUNE);       // one month later
  dateInMay.with(DECEMBER);   // seven months later

Этот экземпляр неизменяем и не изменяется при вызове данного метода.