Класс JapaneseEra

java.lang.Object

java.time.chrono.JapaneseEra

Все реализуемые интерфейсы:: Serializable, Era, TemporalAccessor, TemporalAdjuster

public final class JapaneseEra extends Object implements Era, Serializable

Эра в японской императорской календарной системе.

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

Платформа Java SE поддерживает все эры, определённые правительством Японии, начиная с эры Мэйдзи. Каждая эра идентифицируется на платформе целочисленным значением и названием. Методы of(int) и valueOf(String) можно использовать для получения единственного экземпляра JapaneseEra для каждой эры. Метод values() возвращает единственные экземпляры всех поддерживаемых эр.

Для удобства этот класс объявляет несколько общедоступных статических полей final, ссылающихся на единственные экземпляры, возвращаемые методом values().

Примечание API:

Поля, объявленные в этом классе, могут со временем изменяться в соответствии с результатами метода values(). Однако соответствие между полями и единственными экземплярами не обязательно является взаимно однозначным. Правительство Японии может объявить новую эру и определить дату её начала, но не её официальное название. В этом случае единственный экземпляр, представляющий новую эру, может возвращать название, которое не будет стабильным до утверждения официального названия. Разработчикам следует проявлять осторожность, полагаясь на название, возвращаемое любым единственным экземпляром, которому не соответствует общедоступное статическое поле final.

Требования к реализации:

Этот класс является неизменяемым и потокобезопасным.

Начиная с версии:

1.8

См. также:

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

Модификатор и тип	Поле	Описание
`static final JapaneseEra`	`HEISEI`	Единственный экземпляр эры «Хэйсэй» (1989-01-08 — 2019-04-30), имеющий значение 2.
`static final JapaneseEra`	`MEIJI`	Единственный экземпляр эры «Мэйдзи» (1868-01-01 — 1912-07-29), имеющий значение -1.
`static final JapaneseEra`	`REIWA`	Единственный экземпляр эры «Рэйва» (2019-05-01 — ), имеющий значение 3.
`static final JapaneseEra`	`SHOWA`	Единственный экземпляр эры «Сёва» (1926-12-25 — 1989-01-07), имеющий значение 1.
`static final JapaneseEra`	`TAISHO`	Единственный экземпляр эры «Тайсё» (1912-07-30 — 1926-12-24), имеющий значение 0.

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

Модификатор и тип	Метод	Описание
`String`	`getDisplayName(TextStyle style, Locale locale)`	Возвращает текстовое представление этой эры.
`int`	`getValue()`	Возвращает числовое значение `int` эры.
`static JapaneseEra`	`of(int japaneseEra)`	Получает экземпляр `JapaneseEra` по значению `int`.
`ValueRange`	`range(TemporalField field)`	Возвращает диапазон допустимых значений для указанного поля.
`static JapaneseEra`	`valueOf(String japaneseEra)`	Возвращает `JapaneseEra` с указанным именем.
`static JapaneseEra[]`	`values()`	Возвращает массив японских эр.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Определяет, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения определённого промежутка реального времени.

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

adjustInto, get, getLong, isSupported, query

Модификатор и тип	Метод	Описание
`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)`	Выполняет запрос к этой эре с помощью указанного запроса.

Подробное описание полей

MEIJI

public static final JapaneseEra MEIJI

Единственный экземпляр эры «Мэйдзи» (1868-01-01 — 1912-07-29), имеющий значение -1.

TAISHO

public static final JapaneseEra TAISHO

Единственный экземпляр эры «Тайсё» (1912-07-30 — 1926-12-24), имеющий значение 0.

SHOWA

public static final JapaneseEra SHOWA

Единственный экземпляр эры «Сёва» (1926-12-25 — 1989-01-07), имеющий значение 1.

HEISEI

public static final JapaneseEra HEISEI

Единственный экземпляр эры «Хэйсэй» (1989-01-08 — 2019-04-30), имеющий значение 2.

REIWA

public static final JapaneseEra REIWA

Единственный экземпляр эры «Рэйва» (2019-05-01 — ), имеющий значение 3. Дата окончания этой эры не указана, если только её не определит правительство Японии.

Начиная с версии:: 13

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

of

public static JapaneseEra of(int japaneseEra)

Получает экземпляр JapaneseEra по значению int.

Значение 1 связано с эрой «Сёва», поскольку она включает дату 1970-01-01 (система календаря ISO).
Значения -1 и 0 связаны с двумя более ранними эрами — Мэйдзи и Тайсё соответственно.
Значение больше 1 связано с более поздней эрой, начиная с Хэйсэй (2).

Каждый экземпляр JapaneseEra, возвращаемый методом values(), имеет целочисленное значение (доступное через Era.getValue()), которое принимается этим методом.

Параметры:: japaneseEra — эра, которую требуется представить
Возвращает:: единственный экземпляр JapaneseEra, не null
Выбрасывает:: DateTimeException — если значение недопустимо

valueOf

public static JapaneseEra valueOf(String japaneseEra)

Возвращает JapaneseEra с указанным именем.

Строка должна точно совпадать с названием эры. (Лишние пробельные символы не допускаются.)

Допустимыми являются названия эр, возвращаемые методом values().

Параметры:: japaneseEra — название japaneseEra; не null
Возвращает:: единственный экземпляр JapaneseEra, никогда не null
Выбрасывает:: IllegalArgumentException — если JapaneseEra с указанным именем не существует

values

public static JapaneseEra[] values()

Возвращает массив японских эр. Массив может содержать эры, определённые правительством Японии, помимо известных единственных экземпляров эр.

Этот метод можно использовать для перебора японских эр следующим образом:

for (JapaneseEra c : JapaneseEra.values())
    System.out.println(c);

Возвращает:: массив японских эр

getDisplayName

public String getDisplayName(TextStyle style, Locale locale)

Возвращает текстовое представление этой эры.

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

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

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

getValue

public int getValue()

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

Эра SHOWA, включающая дату 1970-01-01 (система календаря ISO), имеет значение 1. Более поздние эры нумеруются начиная с 2 (HEISEI). Более ранние эры нумеруются как 0 (TAISHO) и -1 (MEIJI).

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

range

public ValueRange range(TemporalField field)

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

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

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

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

Диапазон допустимых японских эр может изменяться со временем из-за особенностей японской календарной системы.

Определено в:: range в интерфейсе Era
Определено в:: range в интерфейсе TemporalAccessor
Параметры:: field — поле, для которого запрашивается диапазон, не null
Возвращает:: диапазон допустимых значений поля, не null
Выбрасывает:: DateTimeException — если диапазон для поля не может быть получен; UnsupportedTemporalTypeException — если единица измерения не поддерживается

© 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.