java.lang.Object
java.util.spi.LocaleServiceProvider
java.util.spi.TimeZoneNameProvider
为提供
TimeZone
类的本地化时区名称的服务提供程序而设计的抽象类。该类的实现提供的本地化时区名称也是DateFormatSymbols.getZoneStrings()
方法的数据源。
- 自版本:
- 1.6
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionabstract String
getDisplayName
(String ID, boolean daylight, int style, Locale locale) 返回适合在指定区域设置向用户展示的给定时区ID的名称。getGenericDisplayName
(String ID, int style, Locale locale) 返回适合在指定locale
向用户展示的给定时区ID
的通用名称。Methods declared in class java.util.spi.LocaleServiceProvider
getAvailableLocales, isSupportedLocale
-
Constructor Details
-
TimeZoneNameProvider
protected TimeZoneNameProvider()唯一构造函数。(通常由子类构造函数隐式调用。)
-
-
Method Details
-
getDisplayName
返回适合在指定区域设置向用户展示的给定时区ID的名称。给定的时区ID是"GMT"或使用"tz数据库"中的"Zone"条目定义的名称之一,"tz数据库"是一个公共领域的时区数据库,位于https://www.iana.org/time-zones。该数据库的数据包含在一个以"tzdata"开头的文件中,数据格式的规范包含在一个以"tzcode"开头的文件中的zic.8手册中。如果
daylight
为true,则该方法应返回适合夏令时的名称,即使指定的时区过去未观察夏令时。- 参数:
-
ID
- 时区ID字符串 -
daylight
- 如果为true,则返回夏令时名称。 -
style
-TimeZone.LONG
或TimeZone.SHORT
-
locale
- 所需的区域设置 - 返回:
- 在给定区域设置中给定时区的可读名称,如果不可用则返回null。
- 抛出:
-
IllegalArgumentException
- 如果style
无效,或locale
不是从getAvailableLocales()
返回的区域设置之一。 -
NullPointerException
- 如果ID
或locale
为null - 外部规范
- 参见:
-
getGenericDisplayName
返回适合在指定locale
向用户展示的给定时区ID
的通用名称。通用时区名称与标准时间和夏令时无关。例如,"PT"是时区IDAmerica/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
-