Module java.base

软件包 java.util.spi

Class TimeZoneNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.TimeZoneNameProvider

public abstract class TimeZoneNameProvider
extends LocaleServiceProvider

为TimeZone类提供本地化时区名称的服务提供商的抽象类。 本类实现中可用的本地化时区名称也是DateFormatSymbols.getZoneStrings()方法的源。

从以下版本开始：

1.6

构造方法摘要

构造方法

Modifier	Constructor	描述
protected	TimeZoneNameProvider()	唯一的构造函数。

方法摘要

Modifier and Type	方法	描述
abstract String	getDisplayName(String ID, boolean daylight, int style, Locale locale)	返回适合在指定语言环境中向用户呈现的给定时区ID的名称。
String	getGenericDisplayName(String ID, int style, Locale locale)	返回给定时区 ID的通用名称，适用于在指定的 locale向用户 locale 。

Methods inherited from class java.util.spi.LocaleServiceProvider

getAvailableLocales, isSupportedLocale

Methods inherited from class 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)

返回适合在指定语言环境中向用户呈现的给定时区ID的名称。 给定的时区ID是“GMT”，或者是使用“tz数据库”中的“区域”条目定义的名称之一，公共域时区数据库是ftp://elsie.nci.nih.gov/pub/ 。 该数据库的数据包含在名称以“tzdata”开头的文件中，数据格式的说明是zic.8手册页的一部分，它包含在名称以“tzcode”开头的文件中。

如果daylight为true，则该方法应返回适合夏令时的名称，即使指定的时区过去没有观察到夏令时。

参数

ID - 时区ID字符串

daylight - 如果为true，则返回夏令时名称。

style - TimeZone.LONG或 TimeZone.SHORT

locale - 所需的语言环境

结果

给定区域中给定时区的人类可读名称，如果不可用，则为null。

异常

IllegalArgumentException - 如果 style无效，或 locale不是从 getAvailableLocales()返回的语言环境 之一 。

NullPointerException - 如果 ID或 locale为空

另请参见：

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

getGenericDisplayName

public String getGenericDisplayName(String ID,
                                    int style,
                                    Locale locale)

返回给定时区ID的通用名称，适用于在指定的locale向用户locale 。 通用时区名称在标准时间和夏令时是中性的。 例如，“PT”是时区ID America/Los_Angeles的简短通用名称，而其标准时间和夏令时间名称分别为“PST”和“PDT”。 有关有效的时区ID，请参阅getDisplayName 。

此方法的默认实现将返回null 。

参数

ID - 时区ID字符串

style - TimeZone.LONG或 TimeZone.SHORT

locale - 所需的语言环境

结果

给定语言环境中给定时区的人类可读的通用名称，如果不可用， null 。

异常

IllegalArgumentException - 如果 style无效，或 locale不是从 getAvailableLocales()返回的区域设置 之一 。

NullPointerException - 如果 ID或 locale是 null

从以下版本开始：

1.8