Java プラットフォーム 1.2

java.util
クラス TimeZone

java.lang.Object
  |
  +--java.util.TimeZone
直接の既知のサブクラス:
SimpleTimeZone

public abstract class TimeZone
extends Object
implements Serializable, Cloneable

TimeZone は、タイムゾーンオフセットを表します。また、夏時間を認識します。

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

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

 TimeZone tz = TimeZone.getTimeZone("PST");
 
getAvailableIDs メソッドを使用して、サポートされているすべてのタイムゾーン ID を調べることができます。サポートされている ID の中から、目的の TimeZone を選択できます。サポートされている ID で必要なタイムゾーンが表されていない場合は、次の構文を使ってカスタムタイムゾーン ID を作成できます。
 GMT[+|-]hh[[:]mm]
 
たとえば、カスタムタイムゾーン ID としてグリニッジ標準時 +14:00 を指定できます。カスタムタイムゾーン ID を指定して返される TimeZone には、夏時間は含まれません。

関連項目:
Calendar, GregorianCalendar, SimpleTimeZone, 直列化された形式

フィールドの概要
static int LONG
          「Pacific Standard Time」などの長い名前を示す getDisplayName() のスタイル指示子です。
static int SHORT
          「PST」などの短い名前を示す getDisplayName() のスタイル指示子です。
 
コンストラクタの概要
TimeZone()
          唯一のコンストラクタです。
 
メソッドの概要
 Object clone()
          Cloneable をオーバーライドします。
static String[] getAvailableIDs()
          サポートされる利用可能な ID をすべて取得します。
static String[] getAvailableIDs(int rawOffset)
          指定されたタイムゾーンオフセットと一致する ID で使用可能なものを取得します。
static TimeZone getDefault()
          このホストのデフォルトの TimeZone を取得します。
 String getDisplayName()
          デフォルトロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。
 String getDisplayName(boolean daylight, int style)
          デフォルトロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。
 String getDisplayName(boolean daylight, int style, Locale locale)
          指定されたロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。
 String getDisplayName(Locale locale)
          指定されたロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。
 String getID()
          現在の所在地のタイムゾーンの ID を取得します。
abstract  int getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)
          現在の日付のタイムゾーンオフセットを返します。
abstract  int getRawOffset()
          未修正のオフセットを返します。
static TimeZone getTimeZone(String ID)
          指定された ID の TimeZone を取得します。
 boolean hasSameRules(TimeZone other)
          このゾーンが比較される別のゾーンと同じ規則とオフセットを持つ場合に true を返します。
abstract  boolean inDaylightTime(Date date)
          指定された日付が、現在の所在地のタイムゾーンでは夏時間の期間内かどうかを問い合わせます。
static void setDefault(TimeZone zone)
          getDefault メソッドで返される TimeZone を設定します。
 void setID(String ID)
          タイムゾーン ID を設定します。
abstract  void setRawOffset(int offsetMillis)
          GMT へのベースタイムゾーンオフセットを設定します。
abstract  boolean useDaylightTime()
          現在の所在地のタイムゾーンが夏時間を使用しているかどうかを問い合わせます。
 
クラス java.lang.Object から継承したメソッド
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

SHORT

public static final int SHORT
「PST」などの短い名前を示す getDisplayName() のスタイル指示子です。
関連項目:
LONG

LONG

public static final int LONG
「Pacific Standard Time」などの長い名前を示す getDisplayName() のスタイル指示子です。
関連項目:
SHORT
コンストラクタの詳細

TimeZone

public TimeZone()
唯一のコンストラクタです。サブクラスのコンストラクタによる呼び出しは、通常は暗黙的な呼び出しです。
メソッドの詳細

getOffset

public abstract int getOffset(int era,
                              int year,
                              int month,
                              int day,
                              int dayOfWeek,
                              int milliseconds)
現在の日付のタイムゾーンオフセットを返します。夏時間の期間内であれば修正されています。これは、ローカルタイムを取得するために UTC に追加するオフセットです。
パラメータ:
era - 指定される日付の時代
year - 指定される日付の年
month - 指定される日付の月。月は 0 から始まる。0 が 1 月
day - 指定される日付の日
dayOfWeek - 指定される日付の曜日
milliseconds - 標準ローカルタイムでの、指定される日のミリ秒
戻り値:
ローカルタイムを取得するために GMT に追加するオフセット

setRawOffset

public abstract void setRawOffset(int offsetMillis)
GMT へのベースタイムゾーンオフセットを設定します。これは、ローカルタイムを取得するために UTC に追加するオフセットです。
パラメータ:
offsetMillis - 指定された GMT へのベースタイムゾーンオフセット

getRawOffset

public abstract int getRawOffset()
未修正のオフセットを返します。これは、ローカルタイムを取得するために UTC に追加するオフセットです。
戻り値:
ローカルタイムを取得するために UTC に追加するための未修正のオフセット

getID

public String getID()
現在の所在地のタイムゾーンの ID を取得します。
戻り値:
現在の所在地のタイムゾーンの ID

setID

public void setID(String ID)
タイムゾーン ID を設定します。タイムゾーンオブジェクト内のほかのデータは変更されません。
パラメータ:
ID - 新しいタイムゾーン ID

getDisplayName

public final String getDisplayName()
デフォルトロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。このメソッドは、長い名前を返します。夏時間は含まれません。ロケールの表示名がない場合、このメソッドは、 GMT[+-]hh:mm の形式で文字列を返します。
戻り値:
デフォルトロケールでの現在のタイムゾーンを、人が理解できる形式にした名前

getDisplayName

public final String getDisplayName(Locale locale)
指定されたロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。このメソッドは、長い名前を返します。夏時間は含まれません。ロケールの表示名がない場合、このメソッドは GMT[+-]hh:mm の形式で文字列を返します。
パラメータ:
locale - 表示名を提供するロケール
戻り値:
指定されたロケールでの現在のタイムゾーンを、人が理解できる形式にした名前。指定されたロケールを認識できない場合は、デフォルトロケールでの名前

getDisplayName

public final String getDisplayName(boolean daylight,
                                   int style)
デフォルトロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。ロケールの表示名がない場合、このメソッドは GMT[+-]hh:mm の形式で文字列を返します。
パラメータ:
daylight - true の場合、夏時間の名前を返す
style - LONG または SHORT のどちらか
戻り値:
デフォルトロケールでの現在のタイムゾーンを、人が理解できる形式にした名前

getDisplayName

public String getDisplayName(boolean daylight,
                             int style,
                             Locale locale)
指定されたロケールでの現在のタイムゾーンの名前を、ユーザへの表示に適した形式で返します。ロケールの表示名がない場合、このメソッドは GMT[+-]hh:mm の形式で文字列を返します。
パラメータ:
daylight - true の場合、夏時間の名前を返す
style - LONG または SHORT のどちらか
locale - 表示名を提供するロケール
戻り値:
指定されたロケールでの現在のタイムゾーンを、人が理解できる形式にした名前。指定されたロケールを認識できない場合は、デフォルトロケールでの名前
例外:
IllegalArgumentException - スタイルが無効な場合

useDaylightTime

public abstract boolean useDaylightTime()
現在の所在地のタイムゾーンが夏時間を使用しているかどうかを問い合わせます。
戻り値:
このタイムゾーンが夏時間を使用している場合は true、そうでない場合は false

inDaylightTime

public abstract boolean inDaylightTime(Date date)
指定された日付が、現在の所在地のタイムゾーンでは夏時間の期間内かどうかを問い合わせます。
パラメータ:
date - 指定される日付
戻り値:
指定された日付が夏時間の期間内の場合は true、そうでない場合は false

getTimeZone

public static TimeZone getTimeZone(String ID)
指定された ID の TimeZone を取得します。
パラメータ:
ID - TimeZone の ID。「PST」のような短縮形式、「America/Los_Angeles」のような完全な名前、あるいは「GMT-8:00」のようなカスタム ID のどれか
戻り値:
指定された TimeZone。指定された ID を認識できない場合は GMT ゾーン

getAvailableIDs

public static String[] getAvailableIDs(int rawOffset)
指定されたタイムゾーンオフセットと一致する ID で使用可能なものを取得します。
パラメータ:
rawOffset - 指定されたタイムゾーンの GMT オフセット
戻り値:
ID の配列。配列内の ID のタイムゾーンは、指定された GMT オフセットと一致する。たとえば、「America/Phoenix」と「America/Denver」はどちらも GMT-07:00 を持つが、夏時間の動作には違いがある

getAvailableIDs

public static String[] getAvailableIDs()
サポートされる利用可能な ID をすべて取得します。
戻り値:
ID の配列

getDefault

public static TimeZone getDefault()
このホストのデフォルトの TimeZone を取得します。デフォルトの TimeZone のソースは、実装によって異なります。
戻り値:
デフォルトの TimeZone

setDefault

public static void setDefault(TimeZone zone)
getDefault メソッドで返される TimeZone を設定します。
パラメータ:
zone - 新しいデフォルトのタイムゾーン

hasSameRules

public boolean hasSameRules(TimeZone other)
このゾーンが比較される別のゾーンと同じ規則とオフセットを持つ場合に true を返します。つまり、このゾーンの ID だけが異なる場合には true を返します。
パラメータ:
other - 比較される TimeZone オブジェクト
戻り値:
指定されたゾーンがこのゾーンと、ID 以外はまったく同じ場合は true

clone

public Object clone()
Cloneable をオーバーライドします。
オーバーライド:
クラス Object 内の clone

Java プラットフォーム 1.2

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.