|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.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
など、Calendar の MONTH
フィールド値によって表されます。day-of-week 値は、SUNDAY
など、Calendar の 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
です。たとえば、夏時間が、ウォール (壁) 時計時間の午前 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 時間) であると仮定します。このコンストラクタは次と同じです。
SimpleTimeZone(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
- ローカルウォール時計時間での夏時間の開始時刻 (1 日内のミリ秒)。この場合、これはローカル標準時間になるendMonth
- 夏時間が終わる月。月は MONTH
のフィールド値 (0から始まる。 つまり、10 月は 9)endDay
- 夏時間が終了する月の日付このパラメータの特例については、クラスの説明を参照endDayOfWeek
- 夏時間が終了する曜日このパラメータの特例については、クラスの説明を参照endTime
- ローカルウォール時計時間での夏時間の終了時刻 (1 日内のミリ秒)。この場合、これはローカル夏時間になる
IllegalArgumentException
- 開始規則または終了規則の月、日、曜日、時刻のいずれかのパラメータが範囲外の場合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
- 開始規則または終了規則の月、日、曜日、時刻のいずれかのパラメータが範囲外の場合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
- 開始規則または終了規則の月、日、曜日、時刻モード、時刻のいずれかのパラメータが範囲外の場合、または時刻モードの値が無効である場合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
- ローカルウォール時計時間での夏時間の終了時刻 (1 日内のミリ秒)。この場合、これはローカル夏時間になる
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
- ローカルウォール時計時間での夏時間の終了時刻 (1 日内のミリ秒)。この場合、これはローカル夏時間になる
IllegalArgumentException
- endMonth
、endDay
、または endTime
パラメータが範囲外の場合public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)
endMonth
- 夏時間が終わる月。月は MONTH
のフィールド値 (0から始まる。 つまり、10 月は 9)endDay
- 夏時間が終了する月の日付endDayOfWeek
- 夏時間が終了する曜日endTime
- ローカルウォール時計時間での夏時間の終了時刻 (1 日内のミリ秒)。この場合、これはローカル夏時間になるafter
- true の場合、この規則は endDay
またはそれ以降の最初の endDayOfWeek
を選択する。false の場合、この規則はその月の endDay
またはそれ以前の最後の endDayOfWeek
を選択する
IllegalArgumentException
- endMonth
、endDay
、endDayOfWeek
、または endTime
パラメータが範囲外の場合public int getOffset(long date)
TimeZone
内の getOffset
date
- タイムゾーンオフセットが見つかった時間
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
内の getOffset
era
- 指定する日付の年号year
- 指定する日付の年month
- 指定する日付の月。月は 0 から始まる。 0 が 1 月day
- 指定する日付の日dayOfWeek
- 指定する日付の曜日millis
- 標準ローカルタイムでの、指定された日のミリ秒
IllegalArgumentException
- era
、month
、day
、dayOfWeek
、または millis
パラメータが範囲外の場合Calendar.ZONE_OFFSET
,
Calendar.DST_OFFSET
public int getRawOffset()
TimeZone
内の getRawOffset
setRawOffset(int)
public void setRawOffset(int offsetMillis)
TimeZone
内の setRawOffset
offsetMillis
- 指定された GMT へのベースタイムゾーンオフセットgetRawOffset()
public void setDSTSavings(int millisSavedDuringDST)
millisSavedDuringDST
- 夏時間規則が有効になった時に標準時間に対して進める時間のミリ秒数。正の数値で、通常は 1 時間 (3600000)getDSTSavings()
public int getDSTSavings()
TimeZone
内の getDSTSavings
setDSTSavings(int)
public boolean useDaylightTime()
TimeZone
内の useDaylightTime
public boolean inDaylightTime(Date date)
TimeZone
内の inDaylightTime
date
- 指定する Date
public Object clone()
SimpleTimeZone
のインスタンスの複製を返します。
TimeZone
内の clone
Cloneable
public int hashCode()
Object
内の hashCode
Object.equals(java.lang.Object)
,
Hashtable
public boolean equals(Object obj)
SimpleTimeZone
オブジェクトが同じであるかどうかを比較します。
Object
内の equals
obj
- 比較される SimpleTimeZone
オブジェクト
obj
がこの SimpleTimeZone
オブジェクトと同じである場合は true、それ以外の場合は falseObject.hashCode()
,
Hashtable
public boolean hasSameRules(TimeZone other)
true
を返します。
TimeZone
内の hasSameRules
other
- 比較される TimeZone オブジェクト
true
public String toString()
Object
内の toString
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。