Перечисление IsoEra
- Все реализуемые интерфейсы:
Serializable, Comparable<IsoEra>, Constable, Era, TemporalAccessor, TemporalAdjuster
public enum IsoEra extends Enum<IsoEra> implements Era
Стандарт ISO-8601 не определяет эры. Поэтому было создано определение с двумя эрами: «Текущая эра» (CE) для лет начиная с 0001-01-01 (ISO) и «До текущей эры» (BCE) для предшествующих лет.
| год в эре | эра | пролептический год |
|---|---|---|
| 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 |
Создает экземпляр IsoEra из значения int. |
static IsoEra |
valueOf |
Возвращает константу перечисления этого класса с указанным именем. |
static IsoEra[] |
values() |
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления. |
Методы, объявленные в классе Enum
clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf | Модификатор и тип | Метод | Описание |
|---|---|---|
protected final Object |
clone() |
Вызывает исключение CloneNotSupportedException. |
final int |
compareTo |
Сравнивает это перечисление с указанным объектом, определяя порядок. |
final Optional |
describeConstable() |
Возвращает дескриптор перечисления EnumDesc для этого экземпляра, если его можно создать, или пустой Optional, если создать его нельзя. |
final boolean |
equals |
Возвращает true, если указанный объект равен этой константе перечисления. |
protected final void |
finalize() |
Устарело, планируется удаление: этот элемент API планируется удалить в будущей версии. Метод финализации помечен как устаревший и планируется к удалению. |
final Class |
getDeclaringClass() |
Возвращает объект Class, соответствующий типу перечисления этой константы перечисления. |
final int |
hashCode() |
Возвращает хеш-код этой константы перечисления. |
final String |
name() |
Возвращает имя этой константы перечисления точно в том виде, в каком оно указано в объявлении перечисления. |
final int |
ordinal() |
Возвращает порядковый номер этой константы перечисления (ее позицию в объявлении перечисления, где первой константе присваивается номер 0). |
String |
toString() |
Возвращает имя этой константы перечисления, указанное в объявлении. |
static <T extends Enum<T>> |
valueOf |
Возвращает константу указанного класса перечисления с указанным именем. |
Методы, объявленные в классе Object
getClass, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или прерывания. |
final void |
wait |
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или прерывания, либо пока не пройдет определенный промежуток реального времени. |
final void |
wait |
Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или прерывания, либо пока не пройдет определенный промежуток реального времени. |
Методы, объявленные в интерфейсе Era
adjustInto, get, getDisplayName, getLong, isSupported, query, range | Модификатор и тип | Метод | Описание |
|---|---|---|
default Temporal |
adjustInto |
Изменяет указанный объект временного типа так, чтобы его эра совпадала с эрой этого объекта. |
default int |
get |
Получает значение указанного поля этой эры в виде int. |
default String |
getDisplayName |
Получает текстовое представление этой эры. |
default long |
getLong |
Получает значение указанного поля этой эры в виде long. |
default boolean |
isSupported |
Проверяет, поддерживается ли указанное поле. |
default <R> R |
query |
Выполняет запрос к этой эре с помощью указанного запроса. |
default ValueRange |
range |
Получает диапазон допустимых значений указанного поля. |
Подробное описание констант перечисления
BCE
public static final IsoEra BCE
CE
public static final IsoEra CE
Подробное описание методов
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
© 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.