模块  java.base
软件包  java.util.spi

Class TimeZoneNameProvider

    • 构造方法详细信息

      • 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.LONGTimeZone.SHORT
        locale - 所需的区域设置
        结果
        给定语言环境中给定时区的人类可读名称,如果不可用,则为null。
        异常
        IllegalArgumentException - 如果 style无效,或 locale不是从 getAvailableLocales()返回的语言环境 之一
        NullPointerException - 如果 IDlocale为空
        另请参见:
        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.LONGTimeZone.SHORT
        locale - 所需的区域设置
        结果
        给定语言环境中给定时区的人类可读通用名称,如果不可用 null
        异常
        IllegalArgumentException - 如果 style无效,或者 locale不是从 getAvailableLocales()返回的语言环境 之一
        NullPointerException - 如果 IDlocalenull
        从以下版本开始:
        1.8