Класс 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()`	Возвращает массив JapaneseEra.

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

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

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

adjustInto, get, getLong, isSupported, 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()

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

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

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

Возвращает:: массив JapaneseEra

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/chrono/JapaneseEra.html