模块 java.base
包 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

  • 构造方法详细信息

    • TimeZoneNameProvider

      protected TimeZoneNameProvider()
      唯一的构造方法。 （对于子类构造方法的调用，通常是隐式的。）

  • 方法详情

    • getDisplayName

      public abstract String  getDisplayName(String  ID, boolean daylight, int style, Locale  locale)
      返回适合在指定区域设置中向用户显示的给定时区 ID 的名称。给定的时区 ID 是“GMT”或使用“tz 数据库”（位于 https://www.iana.org/time-zones 的公共域时区数据库）中的“时区”条目定义的名称之一。该数据库的数据包含在名称以“tzdata”开头的文件中，数据格式的规范是 zic.8 手册页的一部分，它包含在名称以“tzcode”开头的文件中。

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

      参数：
      ID - 时区 ID 字符串
      daylight - 如果为真，则返回夏令时名称。
      style - TimeZone.LONG 或 TimeZone.SHORT
      locale - 所需的locale
      返回：
      给定locale中给定时区的人类可读名称，如果不可用则为 null。
      抛出：
      IllegalArgumentException - 如果 style 无效，或者 locale 不是从 getAvailableLocales() 返回的locale之一。
      NullPointerException - 如果 ID 或 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 - 所需的locale
      返回：
      给定locale中给定时区的人类可读通用名称，如果不可用，则为 null。
      抛出：
      IllegalArgumentException - 如果 style 无效，或者 locale 不是从 getAvailableLocales() 返回的locale之一。
      NullPointerException - 如果 ID 或 locale 是 null
      自从：
      1.8