クラスTimeZone

java.lang.Object

java.util.TimeZone

すべての実装されたインタフェース:

Serializable, Cloneable

直系の既知のサブクラス:

SimpleTimeZone

public abstract class TimeZone extends Object implements Serializable, Cloneable

TimeZoneは、タイ� ゾーン・オフセットを表します。また、サマー・タイ� を認識します。

通常は、getDefaultを使用してTimeZoneを取得します。このメソッドは、プログラ� を実行している� �所のタイ� ゾーンに基づいたTimeZoneを作成します。 たとえば、日本で実行されているプログラ� の� �合、getDefaultは日本標準時を基にTimeZoneオブジェクトを作成します。

タイ� ゾーンIDを指定しgetTimeZoneを使用してTimeZoneを取得することもできます。 たとえば、合衆国太平洋標準時のタイ� ゾーンIDは、「America/Los_Angeles」です。 したがって、次のように入力して合衆国太平洋標準時のTimeZoneオブジェクトを取得できます。

TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");

getAvailableIDsメソッドを使用して、サポートされているすべてのタイ� ゾーンIDを調べることができます。 サポートされているIDの中から、目的のTimeZoneを選択できます。 サポートされているIDのいずれかによって必要なタイ� ゾーンが表されていない� �合は、カスタ� ・タイ� ゾーンIDを指定して、TimeZoneを生成することができます。 カスタ� ・タイ� ゾーンIDの構文は次の通りです。

 CustomID:
         GMT Sign Hours : Minutes : Seconds
         GMT Sign Hours : Minutes
         GMT Sign Hours Minutes
         GMT Sign Hours
 Sign: one of
         + -
 Hours:
         Digit
         Digit Digit
 Minutes:
         Digit Digit
 Seconds:
         Digit Digit
 Digit: one of
         0 1 2 3 4 5 6 7 8 9
 

「時間」は0から23の間、「分」/「秒」は00から59の間である必要があります。 たとえば、「GMT+10」と「GMT+0010」は、それぞれ、GMTより10時間および10分進ん� 時間になります。

フォーマットはロケールに依存せず、数字はUnicode標準のBasic Latinブロックの数字である必要があります。 サマー・タイ� への移行スケジュールは、カスタ� ・タイ� ゾーンIDでは指定できません。 指定された文字列が構文と一致しない� �合は、"GMT"が使用されます。

TimeZoneを作成するときは、指定されたカスタ� ・タイ� ゾーンIDは、次の構文で正規化されます。

 NormalizedCustomID:
         GMT Sign TwoDigitHours : Minutes [ColonSeconds]
 Sign: one of
         + -
 TwoDigitHours:
         Digit Digit
 Minutes:
         Digit Digit
 ColonSeconds:
         : Digit Digit
 Digit: one of
         0 1 2 3 4 5 6 7 8 9
 

たとえば、TimeZone.getTimeZone("GMT-8").getID()はGMT-08:00を返します。 ColonSeconds部分は、秒の値がゼロ以外の� �合にのみ表示されます。

3文字のタイ� ゾーンID

JDK 1.1.xとの互換性のために、その他の3文字のタイ� ゾーンID (「PST」、「CTT」、「AST」など)もサポートされています。 た� し、複数のタイ� ゾーンに同じ省略形が使用されることが多く(「CST」はアメリカの「中央標準時」と「中国標準時」など)、Javaプラットフォー� ではその1つしか認識されないため、この使用は非推奨です。 非推奨の3文字のタイ� ゾーンIDとそのマッピングの完全なリストは、ZoneId.SHORT_IDSで確認できます。

導入されたバージョン:

1.1

関連� �目:

• Calendar
• GregorianCalendar
• SimpleTimeZone
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	LONG	「Pacific Standard Time」などの長い名前を示すgetDisplayName()のスタイル指示子です。
static final int	SHORT	「PST」などの短い名前を示すgetDisplayName()のスタイル指示子です。

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

コンストラクタ

コンストラクタ	説明
TimeZone()	唯一のコンストラクタです。

メソッドのサマリー

修飾子と型	メソッド	説明
Object	clone()	このTimeZoneのコピーを作成します。
static String[]	getAvailableIDs()	サポートされる利用可能なIDをすべて取得します。
static String[]	getAvailableIDs(int rawOffset)	ミリ秒単位で指定されたタイ� ゾーン・オフセットと一致するIDで使用可能なものを取得します。
static TimeZone	getDefault()	Java仮想マシンのデフォルトのTimeZoneを取得します。
final String	getDisplayName()	デフォルト・ロケールでのユーザーへの表示に適した、このTimeZoneの標準時の長い名前を返します。
final String	getDisplayName(boolean daylight, int style)	デフォルト・ロケールでのユーザーへの表示に適した、このTimeZoneの指定されたstyleでの名前を返します。
String	getDisplayName(boolean daylight, int style, Locale locale)	指定された localeでのユーザーへの表示に適した、このTimeZoneの指定されたstyleでの名前を返します。
final String	getDisplayName(Locale locale)	指定されたlocaleでのユーザーへの表示に適した、このTimeZoneの標準時の長い名前を返します。
int	getDSTSavings()	ローカル・ウォール時計時間を取得するために、ローカルの標準時間に追� する時間の量を返します。
String	getID()	現在の所在地のタイ� ゾーンのIDを取得します。
abstract int	getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)	現在の日付のタイ� ゾーン・オフセットを返します。夏時間の期間内であれば修正されています。
int	getOffset(long date)	指定された日付でUTCからのこのタイ� ゾーンのオフセットを返します。
abstract int	getRawOffset()	このタイ� ゾーンの標準時間を取得するために、UTCに追� するミリ秒単位の時間量を返します。
static TimeZone	getTimeZone(String ID)	指定されたIDのTimeZoneを取得します。
static TimeZone	getTimeZone(ZoneId zoneId)	指定されたzoneIdのTimeZoneを取得します。
boolean	hasSameRules(TimeZone other)	このゾーンが比較される別のゾーンと同じルールとオフセットを持つ� �合にtrueを返します。
abstract boolean	inDaylightTime(Date date)	指定されたdateが、このタイ� ゾーンでは夏時間の期間内かどうかを問い合わせます。
boolean	observesDaylightTime()	このTimeZoneが現在夏時間の期間内にある� �合、または標準時間から夏時間への移行が今後行われる� �合にtrueを返します。
static void	setDefault(TimeZone zone)	getDefaultメソッドで返されるTimeZoneを設定します。
void	setID(String ID)	タイ� ゾーンIDを設定します。
abstract void	setRawOffset(int offsetMillis)	GMTへのベース・タイ� ゾーン・オフセットを設定します。
ZoneId	toZoneId()	このTimeZoneオブジェクトをZoneIdに変換します。
abstract boolean	useDaylightTime()	このTimeZoneが夏時間を使用するかどうかを問い合わせます。

クラスjava.lang.Objectで宣言されたメソッド

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

SHORT

public static final int SHORT

「PST」などの短い名前を示すgetDisplayName()のスタイル指示子です。

導入されたバージョン:

1.2

関連� �目:

• LONG
• 定数フィールド値

LONG

public static final int LONG

「Pacific Standard Time」などの長い名前を示すgetDisplayName()のスタイル指示子です。

導入されたバージョン:

1.2

関連� �目:

• SHORT
• 定数フィールド値

コンストラクタの詳細

TimeZone

public TimeZone()

唯一のコンストラクタです。 (サブクラスのコンストラクタによる呼出し用で、通常は暗黙的に呼び出されます。)

メソッドの詳細

getOffset

public abstract int getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)

現在の日付のタイ� ゾーン・オフセットを返します。夏時間の期間内であれば修正されています。 これは、ローカル・タイ� を取得するためにUTCに追� するオフセットです。

基本となるTimeZone実装サブクラスが、夏時間スケジュールとGMTオフセットの歴史的変化をサポートする� �合、このメソッドは歴史的に正確なオフセットを返します。

パラメータ:

era - 指定する日付の年号。

year - 指定する日付の年。

month - 指定する日付の月。 月は 0 から始まる。 0 が 1 月

day - 指定する日付の日。

dayOfWeek - 指定する日付の曜日。

milliseconds - 標準ローカル・タイ� での、指定された日のミリ秒。

戻り値:

ローカル・タイ� を取得するためにGMTに追� するミリ秒単位のオフセット

関連� �目:

• Calendar.ZONE_OFFSET
• Calendar.DST_OFFSET

getOffset

public int getOffset(long date)

指定された日付でUTCからのこのタイ� ゾーンのオフセットを返します。 夏時間が指定された日付で実施されている� �合、オフセット値は夏時間の量で調節されます。

基本となるTimeZone実装サブクラスが、夏時間スケジュールとGMTオフセットの歴史的変化をサポートする� �合、このメソッドは歴史的に正確なオフセット値を返します。

パラメータ:

date - 1970年1月1日00:00:00 GMTからの、ミリ秒単位で表された日付。

戻り値:

ローカル・タイ� を取得するためにUTCに追� するミリ秒単位の時間の量

導入されたバージョン:

1.4

関連� �目:

• Calendar.ZONE_OFFSET
• Calendar.DST_OFFSET

setRawOffset

public abstract void setRawOffset(int offsetMillis)

GMTへのベース・タイ� ゾーン・オフセットを設定します。 これは、ローカル・タイ� を取得するためにUTCに追� するオフセットです。

基盤となるTimeZone実装サブクラスが、GMTオフセットの歴史的変化をサポートする� �合、指定されたGMTオフセットが最新のGMTオフセットとして設定され、既知の最新GMTオフセット値との差を使用して、歴史上のすべてのGMTオフセット値が調整されます。

パラメータ:

offsetMillis - 指定されたGMTへのベース・タイ� ゾーン・オフセット

getRawOffset

public abstract int getRawOffset()

このタイ� ゾーンの標準時間を取得するために、UTCに追� するミリ秒単位の時間量を返します。 この値は夏時間によって影響を受けないので、直接計算したオフセットと呼ばれます。

基本となるTimeZone実装サブクラスがGMTオフセットの歴史的変化をサポートする� �合、メソッドは現在の日付の直接計算されたオフセット値を返します。 たとえばホノルルでは、1947年に直接計算されたオフセットがGMT-10:30からGMT-10:00に変更したので、このメソッドは常に -36000000ミリ秒(つまり -10時間)を返します。

戻り値:

UTCに追� される、ミリ秒単位の直接計算されたオフセット時間の量

関連� �目:

• Calendar.ZONE_OFFSET

getID

public String getID()

現在の所在地のタイ� ゾーンのIDを取得します。

戻り値:

現在の所在地のタイ� ゾーンのID

setID

public void setID(String ID)

タイ� ゾーンIDを設定します。 タイ� ゾーン・オブジェクト内のほかのデータは変更されません。

実装要件:

IDがnullの� �合、デフォルトの実装ではNullPointerExceptionがスローされます

パラメータ:

ID - 新しいタイ� ゾーンID。

スロー:

NullPointerException - IDがnullの� �合、このメソッドはNullPointerExceptionをスローする可能性があります

getDisplayName

public final String getDisplayName()

デフォルト・ロケールでのユーザーへの表示に適した、このTimeZoneの標準時の長い名前を返します。

このメソッドは、次と同等です。

getDisplayName(false, LONG,
               Locale.getDefault(Locale.Category.DISPLAY));

戻り値:

デフォルト・ロケールでの現在のタイ� ゾーンを、人が理解できる形式にした名前

導入されたバージョン:

1.2

関連� �目:

• getDisplayName(boolean, int, Locale)
• Locale.getDefault(Locale.Category)
• Locale.Category

getDisplayName

public final String getDisplayName(Locale locale)

指定されたlocaleでのユーザーへの表示に適した、このTimeZoneの標準時の長い名前を返します。

このメソッドは、次と同等です。

getDisplayName(false, LONG, locale);

パラメータ:

locale - 表示名を提供する際に使われるロケール。

戻り値:

指定されたロケールでの現在のタイ� ゾーンを、人が理解できる形式にした名前

スロー:

NullPointerException - localeがnullの� �合。

導入されたバージョン:

1.2

関連� �目:

• getDisplayName(boolean, int, Locale)

getDisplayName

public final String getDisplayName(boolean daylight, int style)

デフォルト・ロケールでのユーザーへの表示に適した、このTimeZoneの指定されたstyleでの名前を返します。 指定されたdaylightがtrueの� �合は、夏時間の名前が返されます(このTimeZoneが夏時間に従わない� �合でも)。 それ以外の� �合は、標準時の名前が返されます。

このメソッドは、次と同等です。

getDisplayName(daylight, style,
               Locale.getDefault(Locale.Category.DISPLAY));

パラメータ:

daylight - 夏時間の名前を示すtrue、または標準時の名前を示すfalse

style - LONGまたはSHORT

戻り値:

デフォルト・ロケールでの現在のタイ� ゾーンを、人が理解できる形式にした名前

スロー:

IllegalArgumentException - styleが無効である� �合

導入されたバージョン:

1.2

関連� �目:

• getDisplayName(boolean, int, Locale)
• Locale.getDefault(Locale.Category)
• Locale.Category
• DateFormatSymbols.getZoneStrings()

getDisplayName

public String getDisplayName(boolean daylight, int style, Locale locale)

指定された localeでのユーザーへの表示に適した、このTimeZoneの指定されたstyleでの名前を返します。 指定されたdaylightがtrueの� �合は、夏時間の名前が返されます(このTimeZoneが夏時間に従わない� �合でも)。 それ以外の� �合は、標準時の名前が返されます。

タイ� ゾーン名の検索時は、指定されたlocaleから導かれたデフォルトのResourceBundleのLocale検索パスが使用されます。 (フォール・バックLocaleの検索は行われません。) 検索パスのいずれかのLocale (Locale.ROOTも含む)にタイ� ゾーン名が見つかった� �合は、その名前が返されます。 それ以外の� �合は、正規化されたカスタ� ID形式の文字列が返されます。

実装要件:

デフォルトの実装では、styleが無効な� �合はIllegalArgumentExceptionをスローし、IDがnullの� �合はNullPointerExceptionをスローします。

パラメータ:

daylight - 夏時間の名前を示すtrue、または標準時の名前を示すfalse

style - LONGまたはSHORT

locale - 表示名を提供する際に使われるロケール。

戻り値:

指定されたロケールでの現在のタイ� ゾーンを、人が理解できる形式にした名前

スロー:

IllegalArgumentException - styleが無効な� �合、このメソッドはIllegalArgumentExceptionをスローする可能性があります。

NullPointerException - IDがnullの� �合、このメソッドはNullPointerExceptionをスローする可能性があります

導入されたバージョン:

1.2

関連� �目:

• DateFormatSymbols.getZoneStrings()

getDSTSavings

public int getDSTSavings()

ローカル・ウォール時計時間を取得するために、ローカルの標準時間に追� する時間の量を返します。

useDaylightTime()の呼出しがtrueを返す� �合、デフォルト実装は3600000ミリ秒(つまり1時間)を返します。 そうでない� �合は、0を返します。

基本となるTimeZone実装サブクラスが、夏時間スケジュールの歴史的および将来の変化をサポートする� �合、このメソッドは既知の最新夏時間ルールの夏時間量を返します。このルールは将来に予測されるものです。

特定のタイ� スタンプにおける夏時間量が必要な� �合は、この TimeZoneとタイ� スタンプを使用してCalendarを構築し、Calendar.get(Calendar.DST_OFFSET)を呼び出します。

戻り値:

ミリ秒単位の夏時間の量

導入されたバージョン:

1.4

関連� �目:

• inDaylightTime(Date)
• getOffset(long)
• getOffset(int,int,int,int,int,int)
• Calendar.ZONE_OFFSET

useDaylightTime

public abstract boolean useDaylightTime()

このTimeZoneが夏時間を使用するかどうかを問い合わせます。

基本となるTimeZone実装サブクラスが、夏時間スケジュールの歴史的および将来の変化をサポートする� �合、このメソッドは既知の最新夏時間ルールを参照します。このルールは将来に予測されるものであり、現在のルールとは異なる� �合があります。 現在のルールも考慮する必要がある� �合は、observesDaylightTime()を呼び出すようにしてく� さい。

戻り値:

このTimeZoneが夏時間を使用する� �合はtrue、それ以外の� �合はfalse。

関連� �目:

• inDaylightTime(Date)
• Calendar.DST_OFFSET

observesDaylightTime

public boolean observesDaylightTime()

このTimeZoneが現在夏時間の期間内にある� �合、または標準時間から夏時間への移行が今後行われる� �合にtrueを返します。

useDaylightTime()またはinDaylightTime(new Date())がtrueを返す� �合、デフォルト実装はtrueを返します。

戻り値:

このTimeZoneが現在夏時間の期間内にある� �合、または標準時間から夏時間への移行が今後行われる� �合はtrue。それ以外の� �合はfalse。

導入されたバージョン:

1.7

関連� �目:

• useDaylightTime()
• inDaylightTime(Date)
• Calendar.DST_OFFSET

inDaylightTime

public abstract boolean inDaylightTime(Date date)

指定されたdateが、このタイ� ゾーンでは夏時間の期間内かどうかを問い合わせます。

パラメータ:

date - 指定されたDate

戻り値:

指定された日付が夏時間の期間内の� �合はtrue、そうでない� �合はfalse。

スロー:

NullPointerException - dateがnullの� �合、このメソッドはNullPointerExceptionをスローする可能性があります

getTimeZone

public static TimeZone getTimeZone(String ID)

指定されたIDのTimeZoneを取得します。

パラメータ:

ID - TimeZoneのID。「PST」のような短縮形式、「America/Los_Angeles」のような完全な名前、あるいは「GMT-8:00」のようなカスタ� IDのどれか。 短縮形式は、JDK 1.1.xとの互換性のため� けにサポートされているため、完全な名前を使用する必要がある

戻り値:

指定されたTimeZone。指定されたIDを認識できない� �合はGMTゾーン。

スロー:

NullPointerException - IDがnullの� �合

getTimeZone

public static TimeZone getTimeZone(ZoneId zoneId)

指定されたzoneIdのTimeZoneを取得します。

パラメータ:

zoneId - タイ� ゾーンIDの取得元となるZoneId

戻り値:

指定されたTimeZone。指定されたIDを認識できない� �合はGMTゾーン。

スロー:

NullPointerException - zoneIdがnullである� �合

導入されたバージョン:

1.8

toZoneId

public ZoneId toZoneId()

このTimeZoneオブジェクトをZoneIdに変換します。

戻り値:

このTimeZoneと同じタイ� ゾーンを表すZoneId

導入されたバージョン:

1.8

getAvailableIDs

public static String[] getAvailableIDs(int rawOffset)

ミリ秒単位で指定されたタイ� ゾーン・オフセットと一致するIDで使用可能なものを取得します。

パラメータ:

rawOffset - ミリ秒単位で指定されたタイ� ゾーンのGMTオフセット。

戻り値:

IDの配列。配列内のIDのタイ� ゾーンは、指定されたGMTオフセットを持つ。 たとえば、「America/Phoenix」と「America/Denver」はどちらもGMT-07:00を持つが、夏時間の動作には違いがある。

関連� �目:

• getRawOffset()

getAvailableIDs

public static String[] getAvailableIDs()

サポートされる利用可能なIDをすべて取得します。

戻り値:

IDの配列

getDefault

public static TimeZone getDefault()

Java仮想マシンのデフォルトのTimeZoneを取得します。 キャッシュされたデフォルトのTimeZoneが使用可能な� �合は、そのクローンが返されます。 それ以外の� �合、このメソッドは次のステップに従ってデフォルトのタイ� ゾーンを判定します。

• user.timezoneプロパティ値が使用可能な� �合は、デフォルトのタイ� ・ゾーンIDとして使用します。
• プラットフォー� のタイ� ゾーンIDを検出します。 プラットフォー� のタイ� ゾーンとIDのマッピングのソースは、実装によって異なる� �合があります。
• 指定または検出されたタイ� ゾーンIDが不明の� �合は、最後の手段としてGMTを使用します。

このIDから作成されたデフォルトのTimeZoneがキャッシュされ、そのクローンが返されます。 復帰時に、user.timezoneプロパティの値はこのIDに設定されます。

戻り値:

デフォルトのTimeZone

関連� �目:

• setDefault(TimeZone)

setDefault

public static void setDefault(TimeZone zone)

getDefaultメソッドで返されるTimeZoneを設定します。zoneはキャッシュされています。 zoneがnullの� �合は、キャッシュされたデフォルトのTimeZoneがクリアされます。 このメソッドはuser.timezoneプロパティの値を変更しません。

パラメータ:

zone - 新しいデフォルトのTimeZone、またはnull

関連� �目:

• getDefault()

hasSameRules

public boolean hasSameRules(TimeZone other)

このゾーンが比較される別のゾーンと同じルールとオフセットを持つ� �合にtrueを返します。 つまり、このゾーンのID� けが異なる� �合にはtrueを返します。 ほかのゾーンがnullの� �合はfalseを返します。

パラメータ:

other - 比較対象のTimeZoneオブジェクト

戻り値:

他のゾーンがnullで、このゾーンとID以外はまったく同じ� �合はtrue

導入されたバージョン:

1.2

clone

public Object clone()

このTimeZoneのコピーを作成します。

オーバーライド:

clone、クラスObject

戻り値:

このTimeZoneの複製

関連� �目:

• Cloneable