Spec-Zone.ru › OpenJDK 27

Перечисление IsoEra

java.lang.Object
java.lang.Enum<IsoEra>
java.time.chrono.IsoEra
Все реализуемые интерфейсы:
Serializable, Comparable<IsoEra>, Constable, Era, TemporalAccessor, TemporalAdjuster
public enum IsoEra extends Enum<IsoEra> implements Era
Эра в календарной системе ISO.

Стандарт ISO-8601 не определяет эры. Поэтому было создано определение с двумя эрами: «Текущая эра» (CE) для лет начиная с 0001-01-01 (ISO) и «До текущей эры» (BCE) для предшествующих лет.

ISO years and eras
год в эре эра пролептический год
2 CE 2
1 CE 1
1 BCE 0
2 BCE -1

Не используйте ordinal() для получения числового представления IsoEra. Вместо этого используйте getValue().

Требования к реализации:
Это неизменяемое и потокобезопасное перечисление.
Начиная с версии:
1.8

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>
Модификатор и тип Класс Описание
static final class  Enum.EnumDesc<E extends Enum<E>>
Номинальный дескриптор константы enum.

Краткое описание констант перечисления

Константа перечисления Описание
BCE
Единственный экземпляр эры, предшествующей текущей, «До текущей эры», имеющий числовое значение 0.
CE
Единственный экземпляр текущей эры, «Текущая эра», имеющий числовое значение 1.

Краткое описание методов

Модификатор и тип Метод Описание
int getValue()
Возвращает числовое значение эры int.
static IsoEra of(int isoEra)
Создает экземпляр IsoEra из значения int.
static IsoEra valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем.
static IsoEra[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

Методы, объявленные в классе Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
Модификатор и тип Метод Описание
protected final Object clone()
Вызывает исключение CloneNotSupportedException.
final int compareTo(IsoEra o)
Сравнивает это перечисление с указанным объектом, определяя порядок.
final Optional<Enum.EnumDesc<IsoEra>> describeConstable()
Возвращает дескриптор перечисления EnumDesc для этого экземпляра, если его можно создать, или пустой Optional, если создать его нельзя.
final boolean equals(Object other)
Возвращает true, если указанный объект равен этой константе перечисления.
protected final void finalize()
Устарело, планируется удаление: этот элемент API планируется удалить в будущей версии.
Метод финализации помечен как устаревший и планируется к удалению.
final Class<IsoEra> getDeclaringClass()
Возвращает объект Class, соответствующий типу перечисления этой константы перечисления.
final int hashCode()
Возвращает хеш-код этой константы перечисления.
final String name()
Возвращает имя этой константы перечисления точно в том виде, в каком оно указано в объявлении перечисления.
final int ordinal()
Возвращает порядковый номер этой константы перечисления (ее позицию в объявлении перечисления, где первой константе присваивается номер 0).
String toString()
Возвращает имя этой константы перечисления, указанное в объявлении.
static <T extends Enum<T>>
T
valueOf(Class<T> enumClass, String name)
Возвращает константу указанного класса перечисления с указанным именем.

Методы, объявленные в классе Object

getClass, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или прерывания, либо пока не пройдет определенный промежуток реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или прерывания, либо пока не пройдет определенный промежуток реального времени.

Методы, объявленные в интерфейсе Era

adjustInto, get, getDisplayName, getLong, isSupported, query, range
Модификатор и тип Метод Описание
default Temporal adjustInto(Temporal temporal)
Изменяет указанный объект временного типа так, чтобы его эра совпадала с эрой этого объекта.
default int get(TemporalField field)
Получает значение указанного поля этой эры в виде int.
default String getDisplayName(TextStyle style, Locale locale)
Получает текстовое представление этой эры.
default long getLong(TemporalField field)
Получает значение указанного поля этой эры в виде long.
default boolean isSupported(TemporalField field)
Проверяет, поддерживается ли указанное поле.
default <R> R query(TemporalQuery<R> query)
Выполняет запрос к этой эре с помощью указанного запроса.
default ValueRange range(TemporalField field)
Получает диапазон допустимых значений указанного поля.

Подробное описание констант перечисления

BCE

public static final IsoEra BCE
Единственный экземпляр эры, предшествующей текущей, «До текущей эры», имеющий числовое значение 0.

CE

public static final IsoEra CE
Единственный экземпляр текущей эры, «Текущая эра», имеющий числовое значение 1.

Подробное описание методов

values

public static IsoEra[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.
Возвращает:
массив, содержащий константы этого класса перечисления в порядке их объявления

valueOf

public static IsoEra valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Лишние пробельные символы не допускаются.)
Параметры:
name — имя возвращаемой константы перечисления.
Возвращает:
константу перечисления с указанным именем
Вызывает исключение:
IllegalArgumentException — если в этом классе перечисления нет константы с указанным именем
NullPointerException — если аргумент равен null

of

public static IsoEra of(int isoEra)
Создает экземпляр IsoEra из значения int.

IsoEra — это перечисление, представляющее эры ISO BCE/CE. Эта фабрика позволяет получить константу перечисления по значению int.

Параметры:
isoEra — значение BCE/CE, которое требуется представить: от 0 (BCE) до 1 (CE)
Возвращает:
единственный экземпляр эры, не null
Вызывает исключение:
DateTimeException — если значение недопустимо

getValue

public int getValue()
Получает числовое значение эры int.

Эра BCE имеет значение 0, а эра CE — значение 1.

Определено в:
getValue в интерфейсе Era
Возвращает:
значение эры: от 0 (BCE) до 1 (CE)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API