Класс TimeZoneNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.TimeZoneNameProvider

public abstract class TimeZoneNameProvider extends LocaleServiceProvider

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

Since:: 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`.

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

getAvailableLocales, isSupportedLocale

Методы, объявленные в классе java.lang.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 database", общедоступной базе данных часовых поясов по адресу https://www.iana.org/time-zones. Данные этой базы данных содержатся в файле, имя которого начинается с "tzdata", а спецификация формата данных является частью страницы man 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
Since:: 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/spi/TimeZoneNameProvider.html