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