Перечисление IsoEra
- java.lang.Object
-
- java.lang.Enum<IsoEra>
-
- java.time.chrono.IsoEra
- Все реализованные интерфейсы:
-
Serializable,Comparable<IsoEra>,Era,TemporalAccessor,TemporalAdjuster
public enum IsoEra extends Enum<IsoEra> implements Era
Эра в системе календаря ISO.
Стандарт 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
Константы перечисления
| Константа перечисления | Описание |
|---|---|
BCE | Единственный экземпляр для эры до текущей, «До текущей эры», которая имеет числовое значение 0. |
CE | Единственный экземпляр для текущей эры, «Текущая эра», которая имеет числовое значение 1. |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
int | getValue() | Получение числового значения эры |
static IsoEra | of(int isoEra) | Получение экземпляра |
static IsoEra | valueOf(String name) | Возвращает константу перечисления этого типа с указанным именем. |
static IsoEra[] | values() | Возвращает массив, содержащий константы этого типа перечисления в порядке их объявления. |
Методы, объявленные в классе java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf Методы, объявленные в классе java.lang.Object
getClass, notify, notifyAll, wait, wait, wait Методы, объявленные в интерфейсе java.time.chrono.Era
adjustInto, get, getDisplayName, getLong, isSupported, query, range Константы перечисления
BCE
public static final IsoEra BCE
Единственный экземпляр для эры до текущей, «До текущей эры», которая имеет числовое значение 0.
CE
public static final IsoEra CE
Единственный экземпляр для текущей эры, «Текущая эра», которая имеет числовое значение 1.
Методы
values
public static IsoEra[] values()
Возвращает массив, содержащий константы этого типа перечисления в порядке их объявления. Этот метод можно использовать для перебора констант следующим образом:
for (IsoEra c : IsoEra.values()) System.out.println(c);
- Возвращает:
- массив, содержащий константы этого типа перечисления в порядке их объявления
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.
© 1993, 2020, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/chrono/IsoEra.html