Месяц (Платформа Java SE 8 b92)

java.lang. Объект
- java.lang. Перечисление <Месяц>
- - java.time. Месяц

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <Месяц>, TemporalAccessor, TemporalAdjuster
```
public enum Month
extends Enum<Month>
implements TemporalAccessor, TemporalAdjuster
```
Месяц-летнего, такой как 'июль'.
Month перечисление, представляющее 12 месяцев года - январь, февраль, март, апрель, май, июнь, июль, август, сентябрь, октябрь, ноябрь и декабрь.
В дополнение к текстовому перечислимому имени каждый месяц-летнего имеет int значение. int значение следует за нормальным использованием и стандартом ISO 8601, от 1 (январь) к 12 (декабрь). Рекомендуется, чтобы приложения использовали перечисление, а не int значение, чтобы гарантировать ясность кода.
Не использовать ordinal() получить числовое представление Month. Использовать getValue() вместо этого.
Это перечисление представляет общее понятие, которое находится во многих календарных системах. Также, это перечисление может использоваться любой календарной системой, которой определили понятие месяца-летнего, точно эквивалентное календарной системе ISO 8601.

Требования реализации:

Это - неизменное и ориентированное на многопотоковое исполнение перечисление.

С тех пор:

1.8

Перечислимая Постоянная Сводка

Перечислимые Константы
Перечислимая Константа и Описание
`АПРЕЛЬ` Одноэлементный экземпляр в течение месяца апреля с 30 днями.
`АВГУСТ` Одноэлементный экземпляр в течение месяца августа с 31 днем.
`ДЕКАБРЬ` Одноэлементный экземпляр в течение месяца декабря с 31 днем.
`ФЕВРАЛЬ` Одноэлементный экземпляр в течение месяца февраля с 28 днями, или 29 в високосный год.
`ЯНВАРЬ` Одноэлементный экземпляр в течение месяца января с 31 днем.
`ИЮЛЬ` Одноэлементный экземпляр в течение месяца июля с 31 днем.
`ИЮНЬ` Одноэлементный экземпляр в течение месяца июня с 30 днями.
`МАРТ` Одноэлементный экземпляр в течение месяца марта с 31 днем.
`МАЙ` Одноэлементный экземпляр в течение месяца мая с 31 днем.
`НОЯБРЬ` Одноэлементный экземпляр в течение месяца ноября с 30 днями.
`ОКТЯБРЬ` Одноэлементный экземпляр в течение месяца октября с 31 днем.
`СЕНТЯБРЬ` Одноэлементный экземпляр в течение месяца сентября с 30 днями.

Сводка метода

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`Временный`	`adjustInto(Temporal temporal)` Корректирует указанный временный объект иметь в этом месяце-летнего.
`int`	`firstDayOfYear(boolean leapYear)` Получает день-летнего, соответствуя первому дню этого месяца.
`Месяц`	`firstMonthOfQuarter()` Получает месяц, соответствуя первому месяцу этой четверти.
`static Month`	`from(TemporalAccessor temporal)` Получает экземпляр `Month` от временного объекта.
`int`	`get(TemporalField field)` Получает значение указанного поля с этого месяца-летнего как `int`.
`Строка`	`getDisplayName(TextStyle style, Locale locale)` Получает текстовое представление, такое как 'Ян' или 'декабрь'.
`long`	`getLong(TemporalField field)` Получает значение указанного поля с этого месяца-летнего как a `long`.
`int`	`getValue()` Получает месяц-летнего `int` значение.
`boolean`	`isSupported(TemporalField field)` Проверки, если указанное поле поддерживается.
`int`	`length(boolean leapYear)` Получает продолжительность этого месяца в днях.
`int`	`maxLength()` Получает максимальную продолжительность этого месяца в днях.
`int`	`minLength()` Получает минимальную продолжительность этого месяца в днях.
`Месяц`	`minus(long months)` Возвращает месяц-летнего, который является конкретным количеством месяцев перед этим.
`static Month`	`of(int month)` Получает экземпляр `Month` от `int` значение.
`Месяц`	`plus(long months)` Возвращает месяц-летнего, который является конкретным количеством четвертей после этого.
`<R> R`	`query(TemporalQuery<R> query)` Запросы в этом месяце-летнего, используя указанный запрос.
`ValueRange`	`range(TemporalField field)` Получает диапазон допустимых значений для указанного поля.
`static Month`	`valueOf(String name)` Возвращает перечислимую константу этого типа с указанным именем.
`static Month[]`	`values()` Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются.

Методы, наследованные от class java.lang. Перечисление
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Методы, наследованные от class java.lang. Объект
getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.time.temporal. TemporalAdjuster
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame

- Перечислимая Постоянная Деталь
  - ЯНВАРЬ
```
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()
```
    Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются. Этот метод может использоваться, чтобы выполнить итерации по константам следующим образом:
```
for (Month c : Month.values())
 System.out.println(c);
```
    Возвраты:
    
    массив, содержащий константы этого перечислимого типа, в порядке, они объявляются
  - valueOf
```
public static Month valueOf(String name)
```
    Возвращает перечислимую константу этого типа с указанным именем. Строка должна соответствовать точно идентификатор, используемый, чтобы объявить перечислимую константу в этом типе. (Посторонние пробельные символы не разрешаются.)
    
    Параметры:
    
    name - имя перечислимой константы, которая будет возвращена.
    
    Возвраты:
    
    перечислимая константа с указанным именем
    
    Броски:
    
    IllegalArgumentException - если у этого перечислимого типа нет никакой константы с указанным именем
    
    NullPointerException - если параметром является нуль
  - из
```
public static Month of(int month)
```
    Получает экземпляр Month от int значение.
    Month перечисление, представляющее 12 месяцев года. Эта фабрика позволяет перечислению быть полученным из int значение. int значение следует за стандартом ISO 8601, от 1 (январь) к 12 (декабрь).
    
    Параметры:
    
    month - месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)
    
    Возвраты:
    
    месяц-летнего, не нуль
    
    Броски:
    
    DateTimeException - если месяц-летнего недопустим
  - от
```
public static Month from(TemporalAccessor temporal)
```
    Получает экземпляр Month от временного объекта.
    Это получает месяц, основанный на указанном временном. A TemporalAccessor представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр Month.
    Преобразование извлекает MONTH_OF_YEAR поле. Экстракция только разрешается, если временный объект имеет хронологию ISO, или может быть преобразован в a LocalDate.
    Этот метод соответствует подпись функционального интерфейса TemporalQuery разрешение этого использоваться в запросах через ссылку метода, Month::from.
    
    Параметры:
    
    temporal - временный объект преобразовать, не нуль
    
    Возвраты:
    
    месяц-летнего, не нуль
    
    Броски:
    
    DateTimeException - если неспособный преобразовать в a Month
  - getValue
```
public int getValue()
```
    Получает месяц-летнего int значение.
    Значения нумеруются после стандарта ISO 8601, от 1 (январь) к 12 (декабрь).
    
    Возвраты:
    
    месяц-летнего, от 1 (январь) к 12 (декабрь)
  - getDisplayName
```
public String getDisplayName(TextStyle style,
                             Locale locale)
```
    Получает текстовое представление, такое как 'Ян' или 'декабрь'.
    Это возвращает текстовое имя, используемое, чтобы идентифицировать месяц-летнего, подходящий для представления пользователю. Параметры управляют стилем возвращенного текста и локали.
    Если никакое текстовое отображение не находится тогда numeric value возвращается.
    
    Параметры:
    
    style - длина требуемого текста, не нуль
    
    locale - локаль, чтобы использовать, не нуль
    
    Возвраты:
    
    текстовое значение месяца-летнего, не нуль
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    Проверки, если указанное поле поддерживается.
    Это проверяет, может ли этот месяц-летнего быть запрошен для указанного поля. Если ложь, то вызов range и get методы выдадут исключение.
    Если поле MONTH_OF_YEAR тогда этот метод возвращает true. Все другой ChronoField экземпляры возвратят false.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor) передача this как параметр. Поддерживается ли поле, определяется полем.
    
    Определенный:
    
    isSupported в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы проверить, обнулите, возвращает false
    
    Возвраты:
    
    истина, если поле поддерживается на этом месяце-летнего, ложь если нет
  - диапазон
```
public ValueRange range(TemporalField field)
```
    Получает диапазон допустимых значений для указанного поля.
    Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Этот месяц используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле MONTH_OF_YEAR тогда диапазон месяца-летнего, от 1 до 12, будет возвращен. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor) передача this как параметр. Может ли диапазон быть получен, определяется полем.
    
    Определенный:
    
    range в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы запросить диапазон для, не нуль
    
    Возвраты:
    
    диапазон допустимых значений для поля, не нуль
    
    Броски:
    
    DateTimeException - если диапазон для поля не может быть получен
    
    UnsupportedTemporalTypeException - если поле не поддерживается
  - добраться
```
public int get(TemporalField field)
```
    Получает значение указанного поля с этого месяца-летнего как int.
    Это запрашивает в этом месяце для значения для указанного поля. Возвращенное значение всегда будет в пределах допустимого диапазона значений для поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле MONTH_OF_YEAR тогда значение месяца-летнего, от 1 до 12, будет возвращено. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
    
    Определенный:
    
    get в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы получить, не нуль
    
    Возвраты:
    
    значение для поля, в пределах допустимого диапазона значений
    
    Броски:
    
    DateTimeException - если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поля
    
    UnsupportedTemporalTypeException - если поле не поддерживается, или диапазон значений превышает int
    
    ArithmeticException - если числовое переполнение происходит
  - getLong
```
public long getLong(TemporalField field)
```
    Получает значение указанного поля с этого месяца-летнего как a long.
    Это запрашивает в этом месяце для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле MONTH_OF_YEAR тогда значение месяца-летнего, от 1 до 12, будет возвращено. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
    
    Определенный:
    
    getLong в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы получить, не нуль
    
    Возвраты:
    
    значение для поля
    
    Броски:
    
    DateTimeException - если значение для поля не может быть получено
    
    UnsupportedTemporalTypeException - если поле не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - плюс
```
public Month plus(long months)
```
    Возвращает месяц-летнего, который является конкретным количеством четвертей после этого.
    Вычисление катается вокруг конца года с декабря до января. Установленный период может быть отрицательным.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    months - месяцы, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    получающийся месяц, не нуль
  - минус
```
public Month minus(long months)
```
    Возвращает месяц-летнего, который является конкретным количеством месяцев перед этим.
    Вычисление катается вокруг запуска года с января до декабря. Установленный период может быть отрицательным.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    months - месяцы, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    получающийся месяц, не нуль
  - длина
```
public int length(boolean leapYear)
```
    Получает продолжительность этого месяца в днях.
    Это берет флаг, чтобы определить, возвратить ли длину в течение високосного года или нет.
    У февраля есть 28 дней в стандартном году и 29 дней в високосный год. У апреля, июня, сентября и ноября есть 30 дней. У всех других месяцев есть 31 день.
    
    Параметры:
    
    leapYear - истина, если длина требуется в течение високосного года
    
    Возвраты:
    
    продолжительность этого месяца в днях, от 28 до 31
  - minLength
```
public int minLength()
```
    Получает минимальную продолжительность этого месяца в днях.
    У февраля есть минимальная продолжительность 28 дней. У апреля, июня, сентября и ноября есть 30 дней. У всех других месяцев есть 31 день.
    
    Возвраты:
    
    минимальная продолжительность этого месяца в днях, от 28 до 31
  - maxLength
```
public int maxLength()
```
    Получает максимальную продолжительность этого месяца в днях.
    У февраля есть максимальная продолжительность 29 дней. У апреля, июня, сентября и ноября есть 30 дней. У всех других месяцев есть 31 день.
    
    Возвраты:
    
    максимальная продолжительность этого месяца в днях, от 29 до 31
  - firstDayOfYear
```
public int firstDayOfYear(boolean leapYear)
```
    Получает день-летнего, соответствуя первому дню этого месяца.
    Это возвращает день-летнего, который в этом месяце начинается на, используя флаг високосного года, чтобы определить продолжительность февраля.
    
    Параметры:
    
    leapYear - истина, если длина требуется в течение високосного года
    
    Возвраты:
    
    день года, соответствуя первому дню этого месяца, от 1 до 336
  - firstMonthOfQuarter
```
public Month firstMonthOfQuarter()
```
    Получает месяц, соответствуя первому месяцу этой четверти.
    Год может быть разделен на четыре четверти. Этот метод возвращает первый месяц четверти в течение основного месяца. Январь, февраль и март возвращают январь. Апрель, май и июнь возвращают апрель. Июль, август и сентябрь возвращают июль. Октябрь, ноябрь и декабрь возвращают октябрь.
    
    Возвраты:
    
    первый месяц четверти, соответствующей в этом месяце, не нуля
  - запрос
```
public <R> R query(TemporalQuery<R> query)
```
    Запросы в этом месяце-летнего, используя указанный запрос.
    Это запрашивает в этом месяце-летнего, используя указанный объект стратегии запроса. TemporalQuery объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
    Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor) метод на указанной передаче запроса this как параметр.
    
    Определенный:
    
    query в интерфейсе TemporalAccessor
    
    Введите Параметры:
    
    R - тип результата
    
    Параметры:
    
    query - запрос, чтобы вызвать, не нуль
    
    Возвраты:
    
    результат запроса, нуль может быть возвращен (определенный запросом)
    
    Броски:
    
    DateTimeException - если неспособный запрашивать (определенный запросом)
    
    ArithmeticException - если числовое переполнение происходит (определенный запросом)
  - adjustInto
```
public Temporal adjustInto(Temporal temporal)
```
    Корректирует указанный временный объект иметь в этом месяце-летнего.
    Это возвращает временный объект того же самого заметного типа как ввод с месяцем-летнего, измененным, чтобы быть тем же самым как этим.
    Корректировка эквивалентна использованию Temporal.with(TemporalField, long) передача ChronoField.MONTH_OF_YEAR как поле. Если указанный временный объект не использует календарную систему ISO тогда a 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
 
```
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    adjustInto в интерфейсе TemporalAdjuster
    
    Параметры:
    
    temporal - целевой объект, который будет скорректирован, не нуль
    
    Возвраты:
    
    скорректированный объект, не нуль
    
    Броски:
    
    DateTimeException - если неспособный вносить корректировку
    
    ArithmeticException - если числовое переполнение происходит

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Перечислимый Месяц

Перечислимая Постоянная Сводка

Сводка метода

Методы, наследованные от class java.lang. Перечисление

Методы, наследованные от class java.lang. Объект

Методы, наследованные от интерфейса java.time.temporal. TemporalAdjuster

Перечислимая Постоянная Деталь

ЯНВАРЬ

ФЕВРАЛЬ

МАРТ

АПРЕЛЬ

МАЙ

ИЮНЬ

ИЮЛЬ

АВГУСТ

СЕНТЯБРЬ

ОКТЯБРЬ

НОЯБРЬ

ДЕКАБРЬ

Деталь метода

значения

valueOf

из

от

getValue

getDisplayName

isSupported

диапазон

добраться

getLong

плюс

минус

длина

minLength

maxLength

firstDayOfYear

firstMonthOfQuarter

запрос

adjustInto