Spec-Zone.ru › OpenJDK 27

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

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

В календарной системе Минго две эры. Текущая эра, охватывающая годы начиная с 1, известна как эра «Китайская Республика». Все предыдущие годы — нулевые или более ранние в пролептическом счёте либо единичные и более поздние в счёте лет эры — относятся к эре «До Китайской Республики».

Годы и эры календаря Минго
год эры эра пролептический год пролептический год ISO
2 ROC 2 1913
1 ROC 1 1912
1 BEFORE_ROC 0 1911
2 BEFORE_ROC -1 1910

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

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

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

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

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

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

Константа перечисления Описание
BEFORE_ROC
Единственный экземпляр эры, предшествующей текущей эре, — «Эра до Китайской Республики»; её числовое значение — 0.
ROC
Единственный экземпляр текущей эры — «Эра Китайской Республики»; её числовое значение — 1.

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

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

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

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
Модификатор и тип Метод Описание
protected final Object clone()
Выбрасывает CloneNotSupportedException.
final int compareTo(MinguoEra o)
Сравнивает это перечисление с указанным объектом, определяя порядок.
final Optional<Enum.EnumDesc<MinguoEra>> describeConstable()
Возвращает дескриптор перечисления EnumDesc для этого экземпляра, если его можно создать, или пустой Optional, если создать его невозможно.
final boolean equals(Object other)
Возвращает true, если указанный объект равен этой константе перечисления.
protected final void finalize()
Устарел и предназначен для удаления: этот элемент API может быть удалён в будущей версии.
Финализация объявлена устаревшей и предназначена для удаления.
final Class<MinguoEra> getDeclaringClass()
Возвращает объект Class, соответствующий типу перечисления этой константы.
final int hashCode()
Возвращает хеш-код этой константы перечисления.
final String name()
Возвращает имя этой константы перечисления в точности так, как оно объявлено в объявлении перечисления.
final int ordinal()
Возвращает порядковый номер этой константы перечисления (её позицию в объявлении перечисления, где первой константе присваивается порядковый номер ноль).
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 или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать до тех пор, пока он не будет разбужен, обычно в результате вызова notify или interrupt, либо пока не истечёт заданное время.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать до тех пор, пока он не будет разбужен, обычно в результате вызова notify или interrupt, либо пока не истечёт заданное время.

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

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

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

BEFORE_ROC

public static final MinguoEra BEFORE_ROC
Единственный экземпляр эры, предшествующей текущей эре, — «Эра до Китайской Республики»; её числовое значение — 0.

ROC

public static final MinguoEra ROC
Единственный экземпляр текущей эры — «Эра Китайской Республики»; её числовое значение — 1.

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

values

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

valueOf

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

of

public static MinguoEra of(int minguoEra)
Создаёт экземпляр MinguoEra на основе значения int.

MinguoEra — это перечисление, представляющее эры Минго BEFORE_ROC/ROC. Эта фабрика позволяет получить перечисление из значения int.

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

getValue

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

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

Указано в:
getValue в интерфейсе Era
Возвращает:
значение эры: от 0 (BEFORE_ROC) до 1 (ROC)

getDisplayName

public String getDisplayName(TextStyle style, Locale locale)
Возвращает текстовое представление этой эры.

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

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

Указано в:
getDisplayName в интерфейсе Era
Параметры:
style — требуемый стиль текста, не null
locale — используемая локаль, не null
Возвращает:
текстовое значение эры, не null

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по 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