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

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

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

С:

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.

РЕЙВА

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() имеет значение int (доступное через 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()

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

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

 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, 2021, 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/17/docs/api/java.base/java/time/chrono/JapaneseEra.html