Интерфейс 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 - если происходит переполнение числового типа