Класс 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", а спецификация формата данных — в мануале zic.8, который содержится в файле, имя которого начинается с "tzcode".

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

Параметры:

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

daylight - если true, вернуть имя летнего времени.

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

locale - желаемый язык

Возвращает:

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

Исключения:

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

NullPointerException - если ID или locale равно null

См. также:

TimeZone.getDisplayName(boolean, int, java.util.Locale)

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, 2021, 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/17/docs/api/java.base/java/util/spi/TimeZoneNameProvider.html