Класс TimeZoneNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.TimeZoneNameProvider

public abstract class TimeZoneNameProvider extends LocaleServiceProvider

Абстрактный класс поставщиков служб, предоставляющих локализованные названия часовых поясов для класса TimeZone. Локализованные названия часовых поясов, доступные в реализациях этого класса, также являются источником данных для метода DateFormatSymbols.getZoneStrings().

Начиная с:: 1.6

Краткое описание конструкторов

TimeZoneNameProvider()

Модификатор	Конструктор	Описание
`protected`	Единственный конструктор.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract String`	`getDisplayName(String ID, boolean daylight, int style, Locale locale)`	Возвращает название для указанного идентификатора часового пояса, подходящее для отображения пользователю в заданной локали.
`String`	`getGenericDisplayName(String ID, int style, Locale locale)`	Возвращает общее название для указанного `ID` часового пояса, подходящее для отображения пользователю в заданной `locale`.

Методы, объявленные в классе LocaleServiceProvider

getAvailableLocales, isSupportedLocale

Модификатор и тип	Метод	Описание
`abstract Locale[]`	`getAvailableLocales()`	Возвращает массив всех локалей, для которых этот поставщик службы локалей может предоставлять локализованные объекты или названия.
`boolean`	`isSupportedLocale(Locale locale)`	Возвращает `true`, если этот поставщик службы локалей поддерживает указанную `locale`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

TimeZoneNameProvider

protected TimeZoneNameProvider()

Единственный конструктор. (Вызывается конструкторами подклассов, обычно неявно.)

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

getDisplayName

public abstract String getDisplayName(String ID, boolean daylight, int style, Locale locale)

Возвращает название для указанного идентификатора часового пояса, подходящее для отображения пользователю в заданной локали. Указанный идентификатор часового пояса — это «GMT» или одно из названий, определенных с помощью записей «Zone» в «базе данных tz» — общедоступной базе данных часовых поясов по адресу https://www.iana.org/time-zones. Данные этой базы содержатся в файле, имя которого начинается с «tzdata», а спецификация формата данных является частью страницы руководства zic.8, которая находится в файле, имя которого начинается с «tzcode».

Если daylight имеет значение true, метод должен возвращать название, соответствующее летнему времени, даже если в указанном часовом поясе ранее не применялось летнее время.

Параметры:

ID — строка с идентификатором часового пояса

daylight — если значение true, возвращается название для летнего времени.

style — либо TimeZone.LONG, либо TimeZone.SHORT

locale — требуемая локаль

Возвращает:

понятное пользователю название указанного часового пояса в заданной локали или null, если оно недоступно.

Вызывает исключение:

IllegalArgumentException — если style недопустим или locale не входит в список локалей, возвращаемый методом getAvailableLocales().

NullPointerException — если ID или locale имеет значение null

Внешние спецификации

См. также:

getGenericDisplayName

public String getGenericDisplayName(String ID, int style, Locale locale)

Возвращает общее название для указанного ID часового пояса, подходящее для отображения пользователю в заданной locale. Общие названия часовых поясов не зависят от стандартного времени и летнего времени. Например, «PT» — это краткое общее название часового пояса с идентификатором


America/Los_Angeles

, тогда как его краткие названия для стандартного времени и летнего времени — соответственно «PST» и «PDT». Допустимые идентификаторы часовых поясов см. в описании getDisplayName.

Реализация этого метода по умолчанию возвращает null.

Параметры:: ID — строка с идентификатором часового пояса; style — либо TimeZone.LONG, либо TimeZone.SHORT; locale — требуемая локаль
Возвращает:: понятное пользователю общее название указанного часового пояса в заданной локали или null, если оно недоступно.
Вызывает исключение:: IllegalArgumentException — если style недопустим или locale не входит в список локалей, возвращаемый методом getAvailableLocales().; NullPointerException — если ID или locale имеет значение null
Начиная с:: 1.8

© 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.