Класс 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, метод должен вернуть имя, подходящее для летнего времени, даже если указанный часовой пояс не соблюдал летнее время в прошлом.

Параметры:: 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, 2020, 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.