|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.util.TimeZone
TimeZone
は、タイムゾーンオフセットを表します。また、夏時間を認識します。
通常は、getDefault
を使用して TimeZone
を取得します。このメソッドは、プログラムを実行している場所のタイムゾーンに基づいた TimeZone
を作成します。たとえば、日本で実行されているプログラムの場合、getDefault は日本標準時を基に TimeZone
オブジェクトを作成します。
タイムゾーン ID を指定し getTimeZone
を使用して TimeZone
を取得することもできます。たとえば、太平洋標準時のタイムゾーン ID は、「America/Los_Angeles」です。したがって、次のように入力して PST TimeZone
オブジェクトを取得できます。
TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");
getAvailableIDs
メソッドを使用して、サポートされているすべてのタイムゾーン ID を調べることができます。サポートされている ID の中から、目的の TimeZone
を選択できます。サポートされている ID で必要なタイムゾーンが表されていない場合は、次の構文を使ってカスタムタイムゾーン ID を作成できます。
たとえば、カスタムタイムゾーン ID としてグリニッジ標準時 +14:00 を指定できます。カスタムタイムゾーン ID を指定して返されるGMT[+|-]hh[[:]mm]
TimeZone
には、夏時間は含まれません。
JDK 1.1.x との互換性のために、その他の 3 文字のタイムゾーン ID (「PST」、「CTT」、「AST」など) もサポートされています。ただし、複数のタイムゾーンに同じ省略形が使用されることが多く (「CST」はアメリカの「中央標準時」と「中国標準時」など)、Java プラットフォームではその 1 つしか認識されないため、この使用は推奨されません。
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 |
フィールドの詳細 |
public static final int SHORT
getDisplayName()
のスタイル指示子です。LONG
public static final int LONG
getDisplayName()
のスタイル指示子です。SHORT
コンストラクタの詳細 |
public TimeZone()
メソッドの詳細 |
public abstract int getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)
era
- 指定する日付の年号year
- 指定する日付の年month
- 指定する日付の月。月は 0 から始まる。0 が 1 月day
- 指定する日付の日dayOfWeek
- 指定する日付の曜日milliseconds
- 標準ローカルタイムでの、指定される日のミリ秒public abstract void setRawOffset(int offsetMillis)
offsetMillis
- 指定された GMT へのベースタイムゾーンオフセットpublic abstract int getRawOffset()
public String getID()
public void setID(String ID)
ID
- 新しいタイムゾーン IDpublic final String getDisplayName()
GMT[+-]hh:mm
の形式で文字列を返します。public final String getDisplayName(Locale locale)
GMT[+-]hh:mm
の形式で文字列を返します。locale
- 表示名を提供するロケールpublic final String getDisplayName(boolean daylight, int style)
GMT[+-]hh:mm
の形式で文字列を返します。daylight
- true の場合、夏時間の名前を返すstyle
- LONG
または SHORT
のどちらかpublic String getDisplayName(boolean daylight, int style, Locale locale)
GMT[+-]hh:mm
の形式で文字列を返します。daylight
- true の場合、夏時間の名前を返すstyle
- LONG
または SHORT
のどちらかlocale
- 表示名を提供するロケールIllegalArgumentException
- スタイルが無効な場合public abstract boolean useDaylightTime()
public abstract boolean inDaylightTime(Date date)
date
- 指定された Datepublic static TimeZone getTimeZone(String ID)
TimeZone
を取得します。ID
- TimeZone
の ID。「PST」のような短縮形式、「America/Los_Angeles」のような完全な名前、あるいは「GMT-8:00」のようなカスタム ID のどれか。短縮形式は、JDK 1.1.x との互換性のためだけにサポートされているため、完全な名前を使用する必要があるTimeZone
。指定された ID を認識できない場合は GMT ゾーンpublic static String[] getAvailableIDs(int rawOffset)
rawOffset
- 指定されたタイムゾーンの GMT オフセットpublic static String[] getAvailableIDs()
public static TimeZone getDefault()
TimeZone
を取得します。デフォルトの TimeZone
のソースは、実装によって異なります。TimeZone
public static void setDefault(TimeZone zone)
getDefault
メソッドで返される TimeZone
を設定します。zone
が null の場合、VM が最初に開始されたときの値にデフォルトがリセットされます。zone
- 新しいデフォルトのタイムゾーンpublic boolean hasSameRules(TimeZone other)
other
- 比較される TimeZone
オブジェクトpublic Object clone()
Object
内の clone
java.lang.Object
からコピーされたタグ:CloneNotSupportedException
- オブジェクトのクラスが Cloneable
インタフェースをサポートしていない場合。clone
メソッドをオーバーライドしたサブクラスも、インスタンスを複製できないことを示すためにこの例外をスローすることがあるOutOfMemoryError
- 十分なメモリがない場合Cloneable
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.