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)