Класс JapaneseEra

java.lang.Object
- java.time.chrono.JapaneseEra

Все реализованные интерфейсы:: Serializable, Эра, 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 JapaneseEra`	`HEISEI` Одиночный экземпляр для эры '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)` Получение диапазона допустимых значений для указанного поля.
`String`	`toString()` Возвращает строковое представление объекта.
`static JapaneseEra`	`valueOf(String japaneseEra)` Возвращает `JapaneseEra` по имени.
`static JapaneseEra[]`	`values()` Возвращает массив японских эр.

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

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

Методы, унаследованные от интерфейса java.time.chrono.Эра

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

Одиночный экземпляр для эры '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 ассоциируется с более поздней эрой, начиная с Heisei (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()

Возвращает массив японских эр.

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

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

toString

public String toString()

Описание скопировано из класса: Object

Возвращает строковое представление объекта. В общем случае метод toString возвращает строку, которая "текстово представляет" этот объект. Результат должен быть кратким, но информативным представлением, удобным для чтения человеком. Рекомендуется всем подклассам переопределять этот метод.

Метод toString для класса Object возвращает строку, состоящую из имени класса, к которому относится объект, символа @ и неподписанного шестнадцатеричного представления хэш-кода объекта. Другими словами, этот метод возвращает строку, равную значению:

getClass().getName() + '@' + Integer.toHexString(hashCode())

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта.

© 1993, 2020, 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.