|
Unofficial "CLDC 1.0 + MIDP 1.0" API Reference. (日本語版) |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.util.TimeZone
public abstract class TimeZone
グリニッジ標準時 (GMT) からのタイムゾーンオフセットおよびサマータイムを取り扱うクラスです。
サマータイムは夏季時間とも呼ばれ、一部の国および地域で導入されている制度です。 サマータイムとして取り扱われる期間が法律またはそれに準じる慣習として定められた国および地域では、サマータイムが適用される期間はそれ以外の期間の時間から数時間ずらした時間が適用されます。 例えば米国ではサマータイムが 3 月の第 2 日曜日の午前 2 時から 11 月の第 1 日曜日の午前 2 時まで適用されます。 この間、時間はその他の季節の時間よりも1時間早められます。 この米国のサマータイムを 2007 年に適用した場合、
というようになります。
通常使用する TimeZone
オブジェクトは getDefault()
メソッドで取得します。
このメソッドが返す TimeZone
オブジェクトはデバイスが想定するデフォルトのタイムゾーンが設定されています。
例えば日本で実行されるデバイスでは日本標準時 (JST) が設定された TimeZone
オブジェクトを返します。
特定のタイムゾーンに対応する TimeZone
オブジェクトは getTimeZone(java.lang.String)
メソッドにタイムゾーン ID を渡して取得します。
例えば日本時間に対応するオブジェクトを取得する場合はパラメータに"JST"
を渡して取得します。
このクラスの実装は Java 2 Platform, Standard Edition からのサブセットとなっています。
また、getTimeZone(java.lang.String)
メソッドで取り扱うことのできるタイムゾーン ID の書式もサブセットとなっている場合があり、「GMT+9:00
」といったカスタムタイムゾーン ID の指定が無効な場合があります。
常にサポートされるタイムゾーン ID は「GMT
」のみです。
Calendar
コンストラクタの概要 | |
---|---|
TimeZone()
サブクラスのためのデフォルトのコンストラクタです。 |
メソッドの概要 | |
---|---|
static String[] |
getAvailableIDs()
この実装で使用可能な全てのタイムゾーン ID を返します。 |
static TimeZone |
getDefault()
デフォルトの TimeZone オブジェクトを返します。 |
String |
getID()
現在の所在地を表すタイムゾーン ID を返します。 |
abstract int |
getOffset(int era,
int year,
int month,
int day,
int doweek,
int milis)
指定したローカルタイムの日時を得るために、グリニッジ標準時へ加算するオフセットを返します。 |
abstract int |
getRawOffset()
このタイムゾーンのグリニッジ標準時からのオフセットを返します。 |
static TimeZone |
getTimeZone(String ID)
指定されたタイムゾーン ID に対応する TimeZone オブジェクトを返します。 |
abstract boolean |
useDaylightTime()
このタイムゾーンにサマータイムが適用されているかどうかを返します。 |
クラス java.lang.Object から継承されたメソッド |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
public TimeZone()
メソッドの詳細 |
---|
public abstract int getOffset(int era, int year, int month, int day, int doweek, int milis)
指定したローカルタイムの日時を得るために、グリニッジ標準時へ加算するオフセットを返します。 サマータイムが設定されている場合、オフセットにはその情報が反映されます。
era
- 指定する日付が紀元前 (BC) であれば 0
を、紀元後 (AD) であれば 1
を渡します。year
- 指定する日付の年を渡します。month
- 指定する日付の月を渡します。月は Calendar
クラスと同様に1月を 0
とします。day
- 指定する日付の日を渡します。doweek
- 指定する日付の曜日を渡します。milis
- 指定されたローカルタイム日付内でのミリ秒数を渡します。
IllegalArgumentException
- パラメータのいずれかが不正な場合に throw します。public abstract int getRawOffset()
public abstract boolean useDaylightTime()
true
を、適用されていない場合は false
を返します。public String getID()
public static TimeZone getTimeZone(String ID)
指定されたタイムゾーン ID に対応する TimeZone
オブジェクトを返します。
タイムゾーン ID は「JST
」のような短縮形式、あるいは「Japan/Tokyo
」のような完全な名前を使用します。
常にサポートされるタイムゾーン ID は「GMT
」のみです。
ID
- タイムゾーン ID を渡します。
TimeZone
オブジェクトを返します。ただし、タイムゾーン ID が認識できなかった場合は null
を返します。public static TimeZone getDefault()
デフォルトの TimeZone
オブジェクトを返します。
デフォルトとなるタイムゾーンはデバイスおよび実装によって異なります。
TimeZone
オブジェクトを返します。public static String[] getAvailableIDs()
この実装で使用可能な全てのタイムゾーン ID を返します。
|
Unofficial "CLDC 1.0 + MIDP 1.0" API Reference. (日本語版) |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |