java.util.spi
类 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 名称。

从类 java.util.spi.LocaleServiceProvider 继承的方法

getAvailableLocales

从类 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 数据库”中的 "Zone" 条目定义的名称之一，“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 为 null

另请参见：

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