java.util
クラス TimeZone

java.lang.Object
  java.util.TimeZone

public abstract class TimeZone
extends Object

TimeZone オブジェクトはタイムゾーンオフセットを表します。

使用例：

TimeZone tz = TimeZone.getTimeZone("Asia/Tokyo");
TimeZone tz = TimeZone.getDefault();

コンストラクタの概要

TimeZone()
TimeZone オブジェクトを作成します。

メソッドの概要

static String[]	getAvailableIDs() TimeZone で使用可能な全てのタイムゾーンIDを格納している配列を返します。
static TimeZone	getDefault() デフォルトのタイムゾーンを返します。
String	getID() このタイムゾーンのIDを返します。
abstract int	getOffset(int era, int year, int month, int day, int doweek, int milis) 指定された日付での、夏時間調整された、このタイムゾーンのUTCからのオフセットを返します。
abstract int	getRawOffset() このタイムゾーンのUTCからのベースオフセットを返します。
static TimeZone	getTimeZone(String zoneID) 指定されたタイムゾーンIDの TimeZone オブジェクトを返します。
abstract boolean	useDaylightTime() このタイムゾーンで現在夏時間を使用しているかどうかを返します。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

TimeZone

public TimeZone()

TimeZone オブジェクトを作成します。 通常はサブクラスのコンストラクタから暗黙的に呼び出されます。

コンストラクタにより作成したTimeZoneオブジェクトには、IDは設定できません。 getID()の戻り値は空文字となります。

メソッドの詳細

getDefault

public static TimeZone getDefault()

デフォルトのタイムゾーンを返します。

GMT+9を表すタイムゾーンを返します。

戻り値:

デフォルトのタイムゾーン

getID

public String getID()

このタイムゾーンのIDを返します。

戻り値:

タイムゾーンを表すID。

getAvailableIDs

public static String[] getAvailableIDs()

TimeZone で使用可能な全てのタイムゾーンIDを格納している配列を返します。

有効なデータベースが設定されていない場合、長さ 0 の配列を返します。

戻り値:

使用可能な全てのタイムゾーンIDを格納している配列

getTimeZone

public static TimeZone getTimeZone(String zoneID)

指定されたタイムゾーンIDの TimeZone オブジェクトを返します。

パラメータ:

zoneID - タイムゾーンID

戻り値:

指定されたIDのタイムゾーンがサポートされている場合、対応する TimeZone オブジェクトが返ります。サポートされていない場合はGMTゾーンを表す TimeZone オブジェクトが返ります。

例外:

NullPointerException - zoneID が null の場合

getOffset

public abstract int getOffset(int era,
                              int year,
                              int month,
                              int day,
                              int doweek,
                              int milis)

指定された日付での、夏時間調整された、このタイムゾーンのUTCからのオフセットを返します。 このオフセットをUTCに加算してローカルタイムを算出できます。

パラメータ:

era - 年号を指定します。 AD の場合 1 を，BC の場合は 0 を指定してください。

year - 年

month - 月 (1月を0とする0始まりの数値）

day - 月の日 (1日を1とする1始まりの数値）

doweek - 週の日。 以下のどれか： SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY

milis - 日の開始時刻　00:00:00.000 からの経過ミリ秒

戻り値:

UTCからのオフセット（ミリ秒）

getRawOffset

public abstract int getRawOffset()

このタイムゾーンのUTCからのベースオフセットを返します。 このオフセットをUTCに加算してローカルタイムを算出します。 ただしこのオフセットは夏時間の調整を受けていません。

戻り値:

UTCからのオフセット（ミリ秒）

useDaylightTime

public abstract boolean useDaylightTime()

このタイムゾーンで現在夏時間を使用しているかどうかを返します。

戻り値:

現在夏時間を使用している場合 true、使用していない場合 false 。