Module java.base
Package 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
  • Constructor Details

    • TimeZoneNameProvider

      protected TimeZoneNameProvider()
      唯一构造函数。(通常由子类构造函数隐式调用。)
  • Method Details

    • getDisplayName

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

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

      参数:
      ID - 时区ID字符串
      daylight - 如果为true,则返回夏令时名称。
      style - TimeZone.LONGTimeZone.SHORT
      locale - 所需的区域设置
      返回:
      在给定区域设置中给定时区的可读名称,如果不可用则返回null。
      抛出:
      IllegalArgumentException - 如果style无效,或locale不是从getAvailableLocales()返回的区域设置之一。
      NullPointerException - 如果IDlocale为null
      外部规范
      参见:
    • getGenericDisplayName

      public String getGenericDisplayName(String ID, int style, Locale locale)
      返回适合在指定locale向用户展示的给定时区ID的通用名称。通用时区名称与标准时间和夏令时无关。例如,"PT"是时区ID America/Los_Angeles的短通用名称,而其短标准时间和夏令时名称分别为"PST"和"PDT"。有关有效的时区ID,请参阅getDisplayName

      该方法的默认实现返回null

      参数:
      ID - 时区ID字符串
      style - TimeZone.LONGTimeZone.SHORT
      locale - 所需的区域设置
      返回:
      在给定区域设置中给定时区的通用名称,如果不可用则返回null
      抛出:
      IllegalArgumentException - 如果style无效,或locale不是从getAvailableLocales()返回的区域设置之一。
      NullPointerException - 如果IDlocalenull
      自版本:
      1.8