Класс 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 JapaneseEra`	`HEISEI`	Экземпляр для эры 'Хэйсэй' (1989-01-08 - 2019-04-30), значение которой равно 2.
`static JapaneseEra`	`MEIJI`	Экземпляр для эры 'Мэйдзи' (1868-01-01 - 1912-07-29), значение которой равно -1.
`static JapaneseEra`	`SHOWA`	Экземпляр для эры 'Сёва' (1926-12-25 - 1989-01-07), значение которой равно 1.
`static 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

Поля

МЭЙДЗИ

public static final JapaneseEra MEIJI

Экземпляр для эры 'Мэйдзи' (1868-01-01 - 1912-07-29), значение которой равно -1.

ТАЙСЬО

public static final JapaneseEra TAISHO

Экземпляр для эры 'Тайсё' (1912-07-30 - 1926-12-24), значение которой равно 0.

СЬОВА

public static final JapaneseEra SHOWA

Экземпляр для эры 'Сёва' (1926-12-25 - 1989-01-07), значение которой равно 1.

ХЭЙСЭЙ

public static final JapaneseEra HEISEI

Экземпляр для эры 'Хэйсэй' (1989-01-08 - 2019-04-30), значение которой равно 2.

Методы

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 с именем.

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

Параметры:: 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 - если единица не поддерживается