Интерфейс 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'.