Класс JapaneseEra

java.lang.Object

java.time.chrono.JapaneseEra

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

public final class JapaneseEra extends Object implements Era, Serializable

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

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

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

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

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

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

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

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

Cince:

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

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

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

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

adjustInto, get, getLong, isSupported, query

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

MEIJI

public static final JapaneseEra MEIJI

Единственный экземпляр для эры «Мэйдзи» (01.01.1868 - 29.07.1912), имеющий значение -1.

TAISHO

public static final JapaneseEra TAISHO

Единственный экземпляр для эры «Тайсё» (30.07.1912 - 24.12.1926), имеющий значение 0.

SHOWA

public static final JapaneseEra SHOWA

Единственный экземпляр для эры «Сёва» (25.12.1926 - 07.01.1989), имеющий значение 1.

HEISEI

public static final JapaneseEra HEISEI

Единственный экземпляр для эры «Хэйсэй» (08.01.1989 - 30.04.2019), имеющий значение 2.

REIWA

public static final JapaneseEra REIWA

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

С:: 13

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

of

public static JapaneseEra of(int japaneseEra)

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

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

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

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

valueOf

public static JapaneseEra valueOf(String japaneseEra)

Возвращает JapaneseEra по имени.

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

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

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

values

public static JapaneseEra[] values()

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

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

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

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

getDisplayName

public String getDisplayName(TextStyle style, Locale locale)

Получает текстовое представление этой эры.

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

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

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

getValue

public int getValue()

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

Эра «Сёва», содержащая 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/time/chrono/JapaneseEra.html