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