compact1、compact2、compact3

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」になるか、あるいはftp://elsie.nci.nih.gov/pub/の公開ドメイン・タイムゾーン・データベース「tz database」内の「Zone」エントリを使って定義された名前のどれか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