Класс TimeZoneNameProvider

java.lang.Object
- java.util.spi.LocaleServiceProvider
- - java.util.spi.TimeZoneNameProvider

public abstract class TimeZoneNameProvider
extends LocaleServiceProvider

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

Since:: 1.6

Конструкторы

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

Методы

Модификатор и тип	Метод	Описание
`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», которая находится в общественном доступе по адресу ftp://elsie.nci.nih.gov/pub/. Данные этой базы данных содержатся в файле, имя которого начинается с «tzdata», а спецификация формата данных — в мануале zic.8, который содержится в файле, имя которого начинается с «tzcode».

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

Parameters:: ID — строка идентификатора часового пояса; daylight — если true, вернуть имя летнего времени.; style — либо TimeZone.LONG, либо TimeZone.SHORT; locale — желаемая локализация
Returns:: человекочитаемое имя заданного часового пояса в данной локали, или null, если оно недоступно.
Throws:: IllegalArgumentException — если style некорректен, или locale не является одной из локалей, возвращённых из getAvailableLocales().; NullPointerException — если ID или locale равно null
See Also:: 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.

Parameters:: ID — строка идентификатора часового пояса; style — либо TimeZone.LONG, либо TimeZone.SHORT; locale — желаемая локализация
Returns:: человекочитаемое общее имя заданного часового пояса в данной локали, или null , если оно недоступно.
Throws:: IllegalArgumentException — если style некорректен, или locale не является одной из локалей, возвращённых из getAvailableLocales().; NullPointerException — если ID или locale равны null
Since:: 1.8