Класс 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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/spi/TimeZoneNameProvider.html