Перечисление Month

Месяц года, например, 'Июль'.

Month — это перечисление, представляющее 12 месяцев года: январь, февраль, март, апрель, май, июнь, июль, август, сентябрь, октябрь, ноябрь и декабрь.

В дополнение к текстовому имени каждого месяца года присвоено int значение. int значение соответствует общепринятому использованию и стандарту ISO-8601, от 1 (январь) до 12 (декабрь). Рекомендуется, чтобы приложения использовали перечисление вместо int значения для обеспечения ясности кода.

Не используйте ordinal() для получения числового представления Month. Используйте getValue() вместо этого.

Это перечисление представляет собой общее понятие, встречающееся во многих календарных системах. Таким образом, это перечисление может быть использовано любой календарной системой, в которой понятие месяца года определено точно так же, как в календарной системе ISO-8601.

Постоянные значения перечисления

Январь

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.

Методы

values

public static Month[] values()

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

for (Month c : Month.values())
    System.out.println(c);

Возвращает:

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

valueOf

public static Month valueOf(String name)

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

Параметры:

name - имя константы перечисления, которое нужно вернуть.

Возвращает:

константу перечисления с указанным именем

Исключения:

IllegalArgumentException - если в этом типе перечисления нет константы с указанным именем

NullPointerException - если аргумент равен null

of

public static Month of(int month)

Параметры:

month - месяц года, от 1 (январь) до 12 (декабрь)

Возвращает:

месяц года, не null

Исключения:

DateTimeException - если месяц года недействителен

from

public static Month from(TemporalAccessor temporal)

Параметры:

temporal - временной объект для преобразования, не null

Возвращает:

месяц года, не null

Исключения:

DateTimeException - если невозможно преобразовать во Month

getValue

public int getValue()

Возвращает:

месяц года, от 1 (январь) до 12 (декабрь)

getDisplayName

public String getDisplayName(TextStyle style,
                             Locale locale)

Параметры:

style - требуемая длина текста, не null

locale - используемая локаль, не null

Возвращает:

текстовое значение месяца, не null

isSupported

public boolean isSupported(TemporalField field)

Определено в:

isSupported в интерфейсе TemporalAccessor

Параметры:

field - проверяемое поле, null возвращает false

Возвращает:

true, если поле поддерживается этим месяцем, false — в противном случае

range

public ValueRange range(TemporalField field)

Указано в:

range в интерфейсе TemporalAccessor

Параметры:

field - поле для запроса диапазона, не null

Возвращает:

диапазон допустимых значений для поля, не null

Выбрасывает:

DateTimeException - если диапазон для поля получить невозможно

UnsupportedTemporalTypeException - если поле не поддерживается

get

public int get(TemporalField field)

Указано в:

get в интерфейсе TemporalAccessor

Параметры:

field - поле для получения, не null

Возвращает:

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

Выбрасывает:

DateTimeException - если значение для поля получить невозможно или значение находится вне допустимого диапазона значений для поля

UnsupportedTemporalTypeException - если поле не поддерживается или диапазон значений превышает int

ArithmeticException - если происходит переполнение численного типа

getLong

public long getLong(TemporalField field)

Определено в:

getLong в интерфейсе TemporalAccessor

Параметры:

field - поле для получения, не null

Возвращает:

значение для поля

Исключения:

DateTimeException - если значение для поля получить невозможно

UnsupportedTemporalTypeException - если поле не поддерживается

ArithmeticException - если происходит переполнение числового типа

plus

public Month plus(long months)

Параметры:

months - количество месяцев для добавления, положительное или отрицательное

Возвращает:

результирующий месяц, не null

minus

public Month minus(long months)

Параметры:

months - количество месяцев для вычитания, положительное или отрицательное

Возвращает:

результирующий месяц, не null

length

public int length(boolean leapYear)

Параметры:

leapYear - true, если длина требуется для високосного года

Возвращает:

длительность этого месяца в днях, от 28 до 31

minLength

public int minLength()

Возвращает:

минимальную длину текущего месяца в днях, от 28 до 31

maxLength

public int maxLength()

Возвращает:

максимальную длину текущего месяца в днях, от 29 до 31

firstDayOfYear

public int firstDayOfYear(boolean leapYear)

Параметры:

leapYear - true, если требуется длина для високосного года

Возвращает:

день года, соответствующий первому дню этого месяца, от 1 до 336

firstMonthOfQuarter

public Month firstMonthOfQuarter()

Возвращает:

первый месяц квартала, соответствующий этому месяцу, не null

query

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

Указано в:

query в интерфейсе TemporalAccessor

Параметры типа:

R - тип результата

Параметры:

query - запрос для вызова, не null

Возвращает:

результат запроса, может быть null (определяется запросом)

Выбрасывает:

DateTimeException - если запрос не может быть выполнен (определяется запросом)

ArithmeticException - если произошел переполнение числового типа (определяется запросом)

adjustInto

public Temporal adjustInto(Temporal temporal)

// 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

Указано в:

adjustInto в интерфейсе TemporalAdjuster

Параметры:

temporal - целевой объект для настройки, не null

Возвращает:

отрегулированный объект, не null

Выбрасывает:

DateTimeException - если настройка невозможна

ArithmeticException - если произошло переполнение числового типа