模块 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

构造方法摘要

构造方法

变量	构造器	描述
protected	TimeZoneNameProvider()	唯一的构造函数。

方法摘要

变量和类型	方法	描述
abstract String	getDisplayName(String ID, boolean daylight, int style, Locale locale)	返回给定时区ID的名称，该名称适合在指定的语言环境中呈现给用户。
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)

返回给定时区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呈现给用户。 通用时区名称与标准时间和夏令时无关。 例如，“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