Класс 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() возвращает экземпляры всех поддерживаемых эр.

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

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

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

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

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

С:

1.8

См. также:

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

Модификатор и тип	Поле	Описание
`static final JapaneseEra`	`HEISEI`	Экземпляр для эры 'Heisei' (1989-01-08 - 2019-04-30), имеющей значение 2.
`static final JapaneseEra`	`MEIJI`	Экземпляр для эры 'Meiji' (1868-01-01 - 1912-07-29), имеющей значение -1.
`static final JapaneseEra`	`REIWA`	Экземпляр для эры 'Reiwa' (2019-05-01 - ), имеющей значение 3.
`static final JapaneseEra`	`SHOWA`	Экземпляр для эры 'Showa' (1926-12-25 - 1989-01-07), имеющей значение 1.
`static final JapaneseEra`	`TAISHO`	Экземпляр для эры '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.

РЕЙВА

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 - имя 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.

Эра SHOWA, содержащая 01.01.1970 (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, 2023, 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/21/docs/api/java.base/java/time/chrono/JapaneseEra.html