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

  • コンストラクタの詳細

    • 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