Интерфейс TemporalField

default String getDisplayName(Locale locale)

Получает отображаемое имя поля в запрошенном языке.

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

Реализация по умолчанию должна проверить, что язык не равен null, и вернуть toString().

TemporalUnit getBaseUnit()

Получает единицу измерения поля.

Единица поля — это период, изменяющийся в диапазоне. Например, в поле 'MonthOfYear' единицей является 'Months'. См. также getRangeUnit().

TemporalUnit getRangeUnit()

Получает диапазон, в котором ограничено поле.

Диапазон поля — это период, в пределах которого изменяется поле. Например, в поле 'MonthOfYear' диапазон — 'Years'. См. также getBaseUnit().

Диапазон никогда не равен null. Например, поле 'Year' является сокращением для 'YearOfForever'. Следовательно, оно имеет единицу 'Years' и диапазон 'Forever'.

ValueRange range()

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

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

Обратите внимание, что результат описывает только минимальное и максимальное допустимые значения, и не стоит извлекать из них слишком много информации. Например, в диапазоне могут быть значения, недопустимые для поля.

boolean isDateBased()

Проверяет, представляет ли это поле компонент даты.

Поле является основанным на дате, если его можно получить из EPOCH_DAY. Обратите внимание, что для isDateBased() и isTimeBased() допустимо возвращение false, например, при представлении поля, такого как минута недели.

boolean isTimeBased()

Проверяет, представляет ли это поле компонент времени.

Поле является основанным на времени, если его можно получить из NANO_OF_DAY. Обратите внимание, что для isDateBased() и isTimeBased() допустимо возвращение false, например, при представлении поля, такого как минута недели.

boolean isSupportedBy(TemporalAccessor temporal)

Проверяет, поддерживается ли это поле временным объектом.

Это определяет, поддерживает ли временной аксессор это поле. Если это возвращает false, то от временного объекта нельзя запросить это поле.

Существует два эквивалентных способа использования этого метода. Первый — вызвать этот метод непосредственно. Второй — использовать TemporalAccessor.isSupported(TemporalField):

// these two lines are equivalent, but the second approach is recommended
   temporal = thisField.isSupportedBy(temporal);
   temporal = temporal.isSupported(thisField);

Рекомендуется использовать второй подход, isSupported(TemporalField), так как он намного понятнее в коде.

Реализации должны определять, поддерживаются ли они с помощью полей, доступных в ChronoField.

ValueRange rangeRefinedBy(TemporalAccessor temporal)

Получить диапазон допустимых значений для этого поля с использованием временного объекта для уточнения результата.

Это использует временной объект для нахождения диапазона допустимых значений для поля. Это аналогично range(), но этот метод уточняет результат с помощью временного объекта. Например, если поле DAY_OF_MONTH, метод range не точен, так как существует четыре возможных длины месяца: 28, 29, 30 и 31 день. Использование этого метода с датой позволяет сделать диапазон точным, возвращая только один из этих четырех вариантов.

Существует два эквивалентных способа использования этого метода. Первый — вызвать этот метод непосредственно. Второй — использовать TemporalAccessor.range(TemporalField):

// these two lines are equivalent, but the second approach is recommended
   temporal = thisField.rangeRefinedBy(temporal);
   temporal = temporal.range(thisField);

Рекомендуется использовать второй подход, range(TemporalField), так как он намного понятнее в коде.

Реализации должны выполнять любые запросы или вычисления, используя поля, доступные в ChronoField. Если поле не поддерживается, должен быть выброшен UnsupportedTemporalTypeException.

long getFrom(TemporalAccessor temporal)

Получает значение этого поля из указанного временного объекта.

Это запрашивает значение этого поля у временного объекта.

Существует два эквивалентных способа использования этого метода. Первый — вызвать этот метод непосредственно. Второй — использовать TemporalAccessor.getLong(TemporalField) (или TemporalAccessor.get(TemporalField)):

// these two lines are equivalent, but the second approach is recommended
   temporal = thisField.getFrom(temporal);
   temporal = temporal.getLong(thisField);

Рекомендуется использовать второй подход, getLong(TemporalField), так как он намного понятнее в коде.

Реализации должны выполнять любые запросы или вычисления, используя поля, доступные в ChronoField. Если поле не поддерживается, должен быть выброшен UnsupportedTemporalTypeException.

<R extends Temporal> R adjustInto(R temporal,
                                  long newValue)

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

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

В некоторых случаях изменение поля не определено полностью. Например, если целевой объект — дата, представляющая 31 января, а затем изменяется месяц на февраль, то это неясно. В таких случаях реализация отвечает за решение результата. Как правило, она выберет предыдущую допустимую дату, что в данном примере будет последним допустимым днём февраля.

Существует два эквивалентных способа использования этого метода. Первый — вызвать этот метод непосредственно. Второй — использовать Temporal.with(TemporalField, long):

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

Рекомендуется использовать второй подход, with(TemporalField), так как он намного понятнее в коде.

Реализации должны выполнять любые запросы или вычисления, используя поля, доступные в ChronoField. Если поле не поддерживается, должен быть выброшен UnsupportedTemporalTypeException.

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

default TemporalAccessor resolve(Map<TemporalField,Long> fieldValues,
                                 TemporalAccessor partialTemporal,
                                 ResolverStyle resolverStyle)

Разрешает это поле, чтобы предоставить более простую альтернативу или дату.

Этот метод вызывается во время фазы разрешения разбора. Он предназначен для того, чтобы позволить полям, определённым приложением, упрощаться в более стандартные поля, например, те, что в ChronoField, или в дату.

Приложения обычно не должны вызывать этот метод непосредственно.

String toString()

Получает описательное имя для поля.

Должно быть в формате 'BaseOfRange', например, 'MonthOfYear', если поле не имеет диапазона FOREVER, в противном случае указывается только базовая единица, например, 'Year' или 'Era'.