Интерфейс TemporalAccessor

boolean isSupported(TemporalField field)

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

Реализации должны проверять и обрабатывать все поля, определённые в ChronoField. Если поле поддерживается, необходимо вернуть true, в противном случае — false.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.isSupportedBy(TemporalAccessor) с передачей this в качестве аргумента.

Реализации должны гарантировать, что вызов этого метода, выполняющего чтение, не изменяет наблюдаемое состояние.

Параметры:

field — поле для проверки; null возвращает false

Возвращает:

true, если для этой даты и времени можно получить значение поля, иначе false

default ValueRange range(TemporalField field)

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

Реализации должны проверять и обрабатывать все поля, определённые в ChronoField. Если поле поддерживается, необходимо вернуть его диапазон. Если поле не поддерживается, необходимо выбросить UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.rangeRefinedBy(TemporalAccessor) с передачей this в качестве аргумента.

Реализации должны гарантировать, что вызов этого метода, выполняющего чтение, не изменяет наблюдаемое состояние.

Реализация по умолчанию должна вести себя так же, как следующий код:

 if (field instanceof ChronoField) {
   if (isSupported(field)) {
     return field.range();
   }
   throw new UnsupportedTemporalTypeException("Unsupported field: " + field);
 }
 return field.rangeRefinedBy(this);

Параметры:

field — поле, диапазон которого требуется получить; не null

Возвращает:

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

Выбрасывает:

DateTimeException — если не удаётся получить диапазон поля

UnsupportedTemporalTypeException — если поле не поддерживается

default int get(TemporalField field)

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

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

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.getFrom(TemporalAccessor) с передачей this в качестве аргумента.

Реализации должны гарантировать, что вызов этого метода, выполняющего чтение, не изменяет наблюдаемое состояние.

Реализация по умолчанию должна вести себя так же, как следующий код:

 if (range(field).isIntValue()) {
   return range(field).checkValidIntValue(getLong(field), field);
 }
 throw new UnsupportedTemporalTypeException("Invalid field " + field + " + for get() method, use getLong() instead");

Параметры:

field — поле, значение которого требуется получить; не null

Возвращает:

значение поля в пределах допустимого диапазона значений

Выбрасывает:

DateTimeException — если не удаётся получить значение поля или оно находится за пределами допустимого диапазона значений поля

UnsupportedTemporalTypeException — если поле не поддерживается или диапазон значений превышает int

ArithmeticException — при числовом переполнении

long getLong(TemporalField field)

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

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

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.getFrom(TemporalAccessor) с передачей this в качестве аргумента.

Реализации должны гарантировать, что вызов этого метода, выполняющего чтение, не изменяет наблюдаемое состояние.

Параметры:

field — поле, значение которого требуется получить; не null

Возвращает:

значение поля

Выбрасывает:

DateTimeException — если не удаётся получить значение поля

UnsupportedTemporalTypeException — если поле не поддерживается

ArithmeticException — при числовом переполнении

default <R> R query(TemporalQuery<R> query)

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

Реализация по умолчанию должна вести себя так же, как следующий код:

 if (query == TemporalQueries.zoneId() ||
       query == TemporalQueries.chronology() || query == TemporalQueries.precision()) {
   return null;
 }
 return query.queryFrom(this);

В будущих версиях в условный оператор if могут быть добавлены дополнительные запросы.

Все классы, реализующие этот интерфейс и переопределяющие этот метод, должны вызывать TemporalAccessor.super.query(query). Классы JDK могут не вызывать super, если они обеспечивают поведение, эквивалентное поведению реализации по умолчанию; однако классы, не входящие в JDK, не могут использовать эту оптимизацию и должны вызывать super.

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

 if (query == TemporalQueries.precision()) {
   return MINUTES;
 }
 return TemporalAccessor.super.query(query);

Реализации должны гарантировать, что вызов этого метода, выполняющего чтение, не изменяет наблюдаемое состояние.

Параметры типа:

R — тип результата

Параметры:

query — запрос для выполнения; не null

Возвращает:

результат запроса; может быть возвращено значение null (это определяется запросом)

Выбрасывает:

DateTimeException — если невозможно выполнить запрос

ArithmeticException — при числовом переполнении