|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Objectjava.util.TimeZone
java.util.SimpleTimeZone
public class SimpleTimeZone
SimpleTimeZone は、グレゴリオ暦で使用されるタイムゾーンを表す TimeZone の具象サブクラスです。クラスは「直接計算されたオフセット」と呼ばれる、GMT からのオフセット、および夏時間の開始規則および終了規則を保持します。各々の単一値を保持するだけなので、夏時間の実施開始時に setStartYear メソッドが year を指定できることを除いて、GMT および夏時間からのオフセットで歴史上の変更を扱うことはできません。
夏時間を備える SimpleTimeZone を構築するには、start-rule と end-rule の規則セットでスケジュールを記述します。夏時間が開始または終了する日付は、month、day-of-month および day-of-week 値を組み合わせて指定します。month 値は Calendar.MARCH などの、カレンダ MONTH フィールド値で、day-of-week 値は SUNDAY などの、カレンダ DAY_OF_WEEK 値で表します。値の組み合わせの意味は次のとおりです。
MARCH に、day-of-month を 1 に、day-of-week を 0 に設定します。DAY_OF_WEEK フィールド値を設定します。たとえば、4 月の第 2 日曜日を指定するには、month を APRIL に、day-of-month を 8 に、day-of-week を -SUNDAY に設定します。MARCH に、day-of-month は -21、day-of-week は -WEDNESDAY に設定します。DAY_OF_WEEK 値に、day-of-month を -1 に設定します。たとえば、10 月の最終日曜日を指定するには、month を OCTOBER に設定し、day-of-week を SUNDAY に、day-of-month を -1 に設定します。WALL_TIME、STANDARD_TIME および UTC_TIME の 3 種類の mode があります。たとえば、夏時間が、ウォール (壁) 時計時間の午前 2 時で終了する場合、WALL_TIME モードの 7200000 ミリ秒で指定されます。この場合、end-rule のウォール時計時間は夏時間と同じものになります。
次は、タイムゾーンオブジェクトを構築するパラメータの例です。
// Base GMT offset: -8:00
// DST starts: at 2:00am in standard time
// on the first Sunday in April
// DST ends: at 2:00am in daylight time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(-28800000,
"America/Los_Angeles",
Calendar.APRIL, 1, -Calendar.SUNDAY,
7200000,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
7200000,
3600000)
// Base GMT offset: +1:00
// DST starts: at 1:00am in UTC time
// on the last Sunday in March
// DST ends: at 1:00am in UTC time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(3600000,
"Europe/Paris",
Calendar.MARCH, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
3600000)
これらのパラメータの規則は、setStartRule などの、規則設定メソッドにも適用されます。
Calendar,
GregorianCalendar,
TimeZone,
直列化された形式| フィールドの概要 | |
|---|---|
static int |
STANDARD_TIME
標準時間として指定された、開始時間または終了時間のモード定数。 |
static int |
UTC_TIME
UTC として指定された開始時間または終了時間のモードの定数。 |
static int |
WALL_TIME
ウォール時計時間として指定した開始時間または終了時間のモードの定数。 |
| クラス java.util.TimeZone から継承されたフィールド |
|---|
LONG, SHORT |
| コンストラクタの概要 | |
|---|---|
SimpleTimeZone(int rawOffset,
String ID)
夏時間を含まずに、GMT からの指定されたベースタイムゾーンオフセットとタイムゾーン ID により、SimpleTimeZone を構築します。 |
|
SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
GMT からの指定されたベースタイムゾーンオフセット、タイムゾーン ID、および夏時間の開始規則と終了規則で、SimpleTimeZone を構築します。 |
|
SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int dstSavings)
GMT からの指定されたベースタイムゾーンオフセット、タイムゾーン ID、および夏時間の開始規則および終了規則により、SimpleTimeZone を構築します。 |
|
SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int startTimeMode,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int endTimeMode,
int dstSavings)
GMT からの指定されたベースタイムゾーンオフセット、タイムゾーン ID、および夏時間の開始規則および終了規則により、SimpleTimeZone を構築します。 |
|
| メソッドの概要 | |
|---|---|
Object |
clone()
この SimpleTimeZone のインスタンスの複製を返します。 |
boolean |
equals(Object obj)
2 つの SimpleTimeZone オブジェクトが同じであるかどうかを比較します。 |
int |
getDSTSavings()
夏時間に時計を進める時間量をミリ秒単位で返します。 |
int |
getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int millis)
指定した日付および時間について、直接計算したオフセットおよび夏時間の影響を考慮して、ローカル時間と UTC の差異をミリ秒単位で返します。 |
int |
getOffset(long date)
指定された時間で UTC からのこのタイムゾーンのオフセットを返します。 |
int |
getRawOffset()
このタイムゾーンの GMT オフセットを取得します。 |
int |
hashCode()
SimpleDateFormat オブジェクトのハッシュコードを生成します。 |
boolean |
hasSameRules(TimeZone other)
このゾーンが比較された別のゾーンと同じ規則とオフセットを持つ場合に true を返します。 |
boolean |
inDaylightTime(Date date)
指定された日付が夏時間の期間内かどうかを問い合わせます。 |
void |
setDSTSavings(int millisSavedDuringDST)
夏時間の期間に時計を進める時間量をミリ秒単位で設定します。 |
void |
setEndRule(int endMonth,
int endDay,
int endTime)
夏時間の終了規則を月内の固定日に設定します。 |
void |
setEndRule(int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
夏時間の終了規則を設定します。 |
void |
setEndRule(int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
boolean after)
8 日またはそれ以降の最初の月曜日というように、夏時間の終了規則を月内の指定日の前後の平日に設定します。 |
void |
setRawOffset(int offsetMillis)
GMT へのベースタイムゾーンオフセットを設定します。 |
void |
setStartRule(int startMonth,
int startDay,
int startTime)
夏時間の開始規則を月内の固定日に設定します。 |
void |
setStartRule(int startMonth,
int startDay,
int startDayOfWeek,
int startTime)
夏時間の開始規則を設定します。 |
void |
setStartRule(int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
boolean after)
8 日またはそれ以降の最初の月曜日というように、夏時間の開始規則を月内の指定日の前後の平日に設定します。 |
void |
setStartYear(int year)
夏時間が開始された年を設定します。 |
String |
toString()
このタイムゾーンの文字列表現を返します。 |
boolean |
useDaylightTime()
現在の所在地のタイムゾーンが夏時間を使用しているかどうかを問い合わせます。 |
| クラス java.util.TimeZone から継承されたメソッド |
|---|
getAvailableIDs, getAvailableIDs, getDefault, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getID, getTimeZone, setDefault, setID |
| クラス java.lang.Object から継承されたメソッド |
|---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
| フィールドの詳細 |
|---|
public static final int WALL_TIME
public static final int STANDARD_TIME
public static final int UTC_TIME
| コンストラクタの詳細 |
|---|
public SimpleTimeZone(int rawOffset,
String ID)
rawOffset - ミリ秒単位の GMT へのベストタイムゾーンオフセットID - このインスタンスに指定されたタイムゾーン名
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
startTime および endTime がウォール時計時間で表されるように指定します。夏時間の量は、3600000 ミリ秒 (つまり 1 時間) であると仮定します。このコンストラクタは次と同じです。
0SimpleTimeZone(rawOffset,
ID,
startMonth,
startDay,
startDayOfWeek,
startTime,
SimpleTimeZone.WALL_TIME,
endMonth,
endDay,
endDayOfWeek,
endTime,
SimpleTimeZone.WALL_TIME,
3600000)
rawOffset - GMT からの指定されたベースタイムゾーンオフセットID - このオブジェクトに指定されたタイムゾーン IDstartMonth - 夏時間が始まる月。月は MONTH のフィールド値 (0から始まる。つまり、1月は 0)startDay - 夏時間が開始する月の日付。このパラメータの特例については、クラスの説明を参照startDayOfWeek - 夏時間が開始する曜日。このパラメータの特例については、クラスの説明を参照startTime - 日付のミリ秒単位の、ローカルのウォール時計時間での夏時間の開始時間。この場合はローカルの標準時間endMonth - 夏時間が終わる月。月は MONTH のフィールド値 (0から始まる。つまり、10 月は 9)endDay - 夏時間が終了する月の日付。このパラメータの特例については、クラスの説明を参照endDayOfWeek - 夏時間が終了する曜日。このパラメータの特例については、クラスの説明を参照endTime - 日付のミリ秒単位の、ローカルのウォール時計時間での夏時間の終了時間。この場合はローカルの夏時間
IllegalArgumentException - month、day、dayOfWeek、または time パラメータが開始規則または終了規則の範囲外の場合
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int dstSavings)
startTime および endTime の両方がウォール時計時間で表されると仮定されます。このコンストラクタは次と同じです。
SimpleTimeZone(rawOffset,
ID,
startMonth,
startDay,
startDayOfWeek,
startTime,
SimpleTimeZone.WALL_TIME,
endMonth,
endDay,
endDayOfWeek,
endTime,
SimpleTimeZone.WALL_TIME,
dstSavings)
rawOffset - GMT からの指定されたベースタイムゾーンオフセットID - このオブジェクトに指定されたタイムゾーン IDstartMonth - 夏時間が始まる月。月は MONTH のフィールド値 (0から始まる。つまり、1月は 0)startDay - 夏時間が開始する月の日付。このパラメータの特例については、クラスの説明を参照startDayOfWeek - 夏時間が開始する曜日。このパラメータの特例については、クラスの説明を参照startTime - ローカルのウォール時計時間の夏時間の開始時間。この場合はローカルの標準時間endMonth - 夏時間が終わる月。月は MONTH のフィールド値 (0から始まる。つまり、10 月は 9)endDay - 夏時間が終了する月の日付。このパラメータの特例については、クラスの説明を参照endDayOfWeek - 夏時間が終了する曜日。このパラメータの特例については、クラスの説明を参照endTime - ローカルのウォール時計時間の夏時間の終了時間。この場合はローカルの夏時間dstSavings - 夏時間の期間に繰り上げられるミリ秒単位の時間量
IllegalArgumentException - month、day、dayOfWeek、または time パラメータが開始規則または終了規則の範囲外の場合
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int startTimeMode,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int endTimeMode,
int dstSavings)
startTime および endTime のモードなど、フルセットの開始規則と終了規則のパラメータを取得します。モードは wall time、standard time、または UTC time のいずれかを指定します。
rawOffset - GMT からの指定されたベースタイムゾーンオフセットID - このオブジェクトに指定されたタイムゾーン IDstartMonth - 夏時間が始まる月。月は MONTH のフィールド値 (0から始まる。つまり、1月は 0)startDay - 夏時間が開始する月の日付。このパラメータの特例については、クラスの説明を参照startDayOfWeek - 夏時間が開始する曜日。このパラメータの特例については、クラスの説明を参照startTime - startTimeMode によって指定された時間モードでの夏時間の開始時間startTimeMode - startTime によって指定された開始時間のモードendMonth - 夏時間が終わる月。月は MONTH のフィールド値 (0から始まる。つまり、10 月は 9)endDay - 夏時間が終了する月の日付。このパラメータの特例については、クラスの説明を参照endDayOfWeek - 夏時間が終了する曜日。このパラメータの特例については、クラスの説明を参照endTime - endTimeMode によって指定された時間モードでの夏時間の終了時間endTimeMode - endTimeによって指定された終了時間のモードdstSavings - 夏時間の期間に繰り上げられるミリ秒単位の時間量
IllegalArgumentException - month、day、dayOfWeek、time more、または time パラメータが開始規則または終了規則の範囲外の場合。またはタイムモード値が無効の場合WALL_TIME,
STANDARD_TIME,
UTC_TIME| メソッドの詳細 |
|---|
public void setStartYear(int year)
year - 夏時間が開始された年
public void setStartRule(int startMonth,
int startDay,
int startDayOfWeek,
int startTime)
setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);
startMonth - 夏時間が始まる月。月は MONTH のフィールド値 (0から始まる。つまり、1月は 0)startDay - 夏時間が開始する月の日付。このパラメータの特例については、クラスの説明を参照startDayOfWeek - 夏時間が開始する曜日。このパラメータの特例については、クラスの説明を参照startTime - ローカルのウォール時計時間の夏時間の開始時間。この場合はローカルの標準時間
IllegalArgumentException - startMonth、startDay、startDayOfWeek、または startTime パラメータが範囲外の場合
public void setStartRule(int startMonth,
int startDay,
int startTime)
setStartRule(startMonth, startDay, 0, startTime)
startMonth - 夏時間が始まる月。月は MONTH のフィールド値 (0から始まる。つまり、1月は 0)startDay - 夏時間が始まる月の日付startTime - ローカルのウォールクロックタイムの夏時間の開始時間。この場合はローカルの標準時間。このパラメータの特例については、クラスの説明を参照
IllegalArgumentException - startMonth、startDayOfMonth、または startTime パラメータが範囲外の場合
public void setStartRule(int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
boolean after)
startMonth - 夏時間が始まる月。月は MONTH のフィールド値 (0から始まる。つまり、1月は 0)startDay - 夏時間が開始する月の日付startDayOfWeek - 夏時間が開始する曜日startTime - ローカルのウォール時計時間の夏時間の開始時間。この場合はローカルの標準時間after - true の場合、この規則は dayOfMonth またはそれ以降の最初の dayOfWeek を選択する。false の場合、この規則は dayOfMonth またはそれ以前の最後の dayOfWeek を選択する
IllegalArgumentException - startMonth、startDay、startDayOfWeek、または startTime パラメータが範囲外の場合
public void setEndRule(int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);
endMonth - 夏時間が終わる月。月は MONTH のフィールド値 (0から始まる。つまり、10 月は 9)endDay - 夏時間が終了する月の日付。このパラメータの特例については、クラスの説明を参照endDayOfWeek - 夏時間が終了する曜日。このパラメータの特例については、クラスの説明を参照endTime - 日付のミリ秒単位の、ローカルのウォール時計時間での夏時間の終了時間。この場合はローカルの夏時間
IllegalArgumentException - endMonth、endDay、endDayOfWeek または endTime パラメータが範囲外の場合
public void setEndRule(int endMonth,
int endDay,
int endTime)
setEndRule(endMonth, endDay, 0, endTime)
endMonth - 夏時間が終わる月。月は MONTH のフィールド値 (0から始まる。つまり、10 月は 9)endDay - 夏時間が終了する月の日付endTime - 日付のミリ秒単位の、ローカルのウォール時計時間での夏時間の終了時間。この場合はローカルの夏時間
IllegalArgumentException - endMonth、endDay、endDayOfWeek または endTime パラメータが範囲外の場合
public void setEndRule(int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
boolean after)
endMonth - 夏時間が終わる月。月は MONTH のフィールド値 (0から始まる。つまり、10 月は 9)endDay - 夏時間が終了する月の日付endDayOfWeek - 夏時間が終了する曜日endTime - 日付のミリ秒単位の、ローカルのウォール時計時間での夏時間の終了時間。この場合はローカルの夏時間after - trueの場合、この規則は endDay またはそれ以降の最初の endDayOfWeek を選択する。false の場合、この規則は月の endDay またはそれ以前の endDayOfWeek を選択する
IllegalArgumentException - endMonth、endDay、endDayOfWeek または endTime パラメータが範囲外の場合public int getOffset(long date)
TimeZone 内の getOffsetdate - タイムゾーンオフセットが見つかった時間
Calendar.ZONE_OFFSET,
Calendar.DST_OFFSET
public int getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int millis)
GregorianCalendar オブジェクトが使用されます。デフォルトの GregorianCalendar 以外のカレンダで、このメソッドの結果を使用しないでください。
注: 通常、クライアントはこのメソッドを呼び出すのではなく、Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET) を使用します。
TimeZone 内の getOffsetera - 指定する日付の年号year - 指定する日付の年month - 指定する日付の月。月は 0 から始まる。たとえば、1 月は 0day - 指定する日付の日dayOfWeek - 指定する日付の曜日millis - 標準ローカルタイムでの、指定された日のミリ秒
IllegalArgumentException - era、month、day、dayOfWeek または millis パラメータが範囲外の場合Calendar.ZONE_OFFSET,
Calendar.DST_OFFSETpublic int getRawOffset()
TimeZone 内の getRawOffsetsetRawOffset(int)public void setRawOffset(int offsetMillis)
TimeZone 内の setRawOffsetoffsetMillis - 指定された GMT へのベースタイムゾーンオフセットgetRawOffset()public void setDSTSavings(int millisSavedDuringDST)
millisSavedDuringDST - 夏時間規則が始まるときに標準時から進めるミリ秒単位の時間量。正の数値で、通常は 1 時間 (3600000)getDSTSavings()public int getDSTSavings()
TimeZone 内の getDSTSavingssetDSTSavings(int)public boolean useDaylightTime()
TimeZone 内の useDaylightTimepublic boolean inDaylightTime(Date date)
TimeZone 内の inDaylightTimedate - 指定された Date
public Object clone()
SimpleTimeZone のインスタンスの複製を返します。
TimeZone 内の cloneCloneablepublic int hashCode()
Object 内の hashCodeObject.equals(java.lang.Object),
Hashtablepublic boolean equals(Object obj)
SimpleTimeZone オブジェクトが同じであるかどうかを比較します。
Object 内の equalsobj - 比較される SimpleTimeZone オブジェクト
obj がこのSimpleTimeZone オブジェクトと同じである場合は true、そうでない場合は falseObject.hashCode(),
Hashtablepublic boolean hasSameRules(TimeZone other)
true を返します。
TimeZone 内の hasSameRulesother - 比較される TimeZone オブジェクト
truepublic String toString()
Object 内の toString
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。