モジュール 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

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	TimeZoneNameProvider()	唯一のコンストラクタです。

メソッドのサマリー

修飾子と型	メソッド	説明
abstract String	getDisplayName(String ID, boolean daylight, int style, Locale locale)	指定されたタイムゾーンIDの名前を、指定されたロケールのユーザーへの表示に適した形式で返します。
String	getGenericDisplayName(String ID, int style, Locale locale)	指定されたタイムゾーンIDのジェネリック名を、指定されたlocaleのユーザーへの表示に適した形式で返します。

クラスjava.util.spi.LocaleServiceProviderで宣言されたメソッド

getAvailableLocales, isSupportedLocale

クラス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"、またはhttps://www.iana.org/time-zonesでの公開ドメイン・タイム・ゾーン・データベースである"tzデータベース"内の"ゾーン"エントリを使用して定義された名前の1つです。 このデータベースのデータは「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)

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 - 目的のロケール

戻り値:

指定されたロケールでの、指定されたタイムゾーンの人間が読める形式のジェネリック名。またはそれが使用可能でない場合はnull。

例外:

IllegalArgumentException - styleが無効であるか、localeがgetAvailableLocales()から返されたロケールのいずれでもない場合。

NullPointerException - IDまたはlocaleがnullである場合

導入されたバージョン:

1.8