Интерфейс Era

int getValue()

Получает числовое значение, связанное с эрой согласно определению хронологии. Каждая хронология определяет предустановленные эры и методы для получения списка эр этой хронологии.

Каждому полю, включая эры, соответствует числовое значение. Значение числа для эры определяется хронологией согласно следующим принципам:

• Эра, действовавшая на момент эпохи 1970-01-01 (ISO), имеет значение 1.
• Более поздние эры имеют последовательно возрастающие значения.
• Более ранние эры имеют последовательно убывающие значения, которые могут быть отрицательными.

default boolean isSupported(TemporalField field)

Проверяет, поддерживается ли указанное поле.

Проверяет, можно ли запросить у этой эры значение указанного поля. Если результат отрицательный, вызовы методов range и get приведут к выбросу исключения.

Если поле является ChronoField, запрос обрабатывается здесь. Для поля ERA возвращается true. Для всех остальных экземпляров ChronoField возвращается false.

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

default ValueRange range(TemporalField field)

Получает диапазон допустимых значений для указанного поля.

Объект диапазона задаёт минимальное и максимальное допустимые значения поля. Эта эра используется для повышения точности возвращаемого диапазона. Если вернуть диапазон невозможно, поскольку поле не поддерживается или по другой причине, выбрасывается исключение.

Если поле является ChronoField, запрос обрабатывается здесь. Для поля ERA возвращается диапазон. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

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

Реализация по умолчанию должна возвращать для ERA диапазон от нуля до единицы, подходящий для календарных систем с двумя эрами, таких как ISO.

default int get(TemporalField field)

Получает значение указанного поля для этой эры в виде int.

Запрашивает у этой эры значение указанного поля. Возвращаемое значение всегда будет находиться в допустимом диапазоне значений поля. Если вернуть значение невозможно, поскольку поле не поддерживается или по другой причине, выбрасывается исключение.

Если поле является ChronoField, запрос обрабатывается здесь. Для поля ERA возвращается значение эры. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

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

default long getLong(TemporalField field)

Получает значение указанного поля для этой эры в виде long.

Запрашивает у этой эры значение указанного поля. Если вернуть значение невозможно, поскольку поле не поддерживается или по другой причине, выбрасывается исключение.

Если поле является ChronoField, запрос обрабатывается здесь. Для поля ERA возвращается значение эры. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

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

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

Выполняет запрос к этой эре с помощью указанного запроса.

Запрашивает у этой эры данные с помощью указанного объекта стратегии запроса. Объект TemporalQuery задаёт логику получения результата. Чтобы понять, каким будет результат этого метода, ознакомьтесь с документацией запроса.

Результат этого метода получается вызовом метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса с передачей this в качестве аргумента.

default Temporal adjustInto(Temporal temporal)

Изменяет указанный объект временной шкалы так, чтобы его эра совпадала с эрой этого объекта.

Возвращает объект временной шкалы того же наблюдаемого типа, что и входной объект, изменив его эру на эру этого объекта.

Это изменение эквивалентно вызову Temporal.with(TemporalField, long) с передачей ChronoField.ERA в качестве поля.

В большинстве случаев понятнее изменить порядок вызова, используя Temporal.with(TemporalAdjuster):

  // these two lines are equivalent, but the second approach is recommended
  temporal = thisEra.adjustInto(temporal);
  temporal = temporal.with(thisEra);

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

default String getDisplayName(TextStyle style, Locale locale)

Получает текстовое представление этой эры.

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

Если текстовое соответствие не найдено, возвращается numeric value.