Класс 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 man page, имя файла которой начинается с "tzcode".

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

Parameters:

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

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

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

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

Returns:

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

Throws:

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

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

External Specifications

See Also:

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

© 1993, 2023, 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/21/docs/api/java.base/java/util/spi/TimeZoneNameProvider.html