|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.util.TimeZone | +--java.util.SimpleTimeZone
SimpleTimeZone
is a concrete subclass of TimeZone
that represents a time zone for use with a Gregorian calendar. This
class does not handle historical changes.
Use a negative value for dayOfWeekInMonth
to indicate that
SimpleTimeZone
should count from the end of the month backwards.
For example, Daylight Savings Time ends at the last
(dayOfWeekInMonth = -1) Sunday in October, at 2 AM in standard time.
Calendar
,
GregorianCalendar
,
TimeZone
, Serialized FormFields inherited from class java.util.TimeZone |
LONG,
SHORT |
Constructor Summary | |
SimpleTimeZone(int rawOffset,
String ID)
Constructs a SimpleTimeZone with the given base time zone offset from GMT and time zone ID. |
|
SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
Construct a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, time to start and end the daylight time. |
|
SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int dstSavings)
Constructor. |
Method Summary | |
Object |
clone()
Overrides Cloneable |
boolean |
equals(Object obj)
Compares the equality of two SimpleTimeZone objects. |
int |
getDSTSavings()
Returns the amount of time in ms that the clock is advanced during DST. |
int |
getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int millis)
Overrides TimeZone Gets offset, for current date, modified in case of daylight savings. |
int |
getRawOffset()
Overrides TimeZone Gets the GMT offset for this time zone. |
int |
hashCode()
Override hashCode. |
boolean |
hasSameRules(TimeZone other)
Return true if this zone has the same rules and offset as another zone. |
boolean |
inDaylightTime(Date date)
Overrides TimeZone Queries if the given date is in Daylight Savings Time. |
void |
setDSTSavings(int millisSavedDuringDST)
Sets the amount of time in ms that the clock is advanced during DST. |
void |
setEndRule(int month,
int dayOfMonth,
int time)
Sets the DST end rule to a fixed date within a month. |
void |
setEndRule(int month,
int dayOfWeekInMonth,
int dayOfWeek,
int time)
Sets the daylight savings ending rule. |
void |
setEndRule(int month,
int dayOfMonth,
int dayOfWeek,
int time,
boolean after)
Sets the DST end rule to a weekday before or after a give date within a month, e.g., the first Monday on or after the 8th. |
void |
setRawOffset(int offsetMillis)
Overrides TimeZone Sets the base time zone offset to GMT. |
void |
setStartRule(int month,
int dayOfMonth,
int time)
Sets the DST start rule to a fixed date within a month. |
void |
setStartRule(int month,
int dayOfWeekInMonth,
int dayOfWeek,
int time)
Sets the daylight savings starting rule. |
void |
setStartRule(int month,
int dayOfMonth,
int dayOfWeek,
int time,
boolean after)
Sets the DST start rule to a weekday before or after a give date within a month, e.g., the first Monday on or after the 8th. |
void |
setStartYear(int year)
Sets the daylight savings starting year. |
String |
toString()
Return a string representation of this time zone. |
boolean |
useDaylightTime()
Overrides TimeZone Queries if this time zone uses Daylight Savings Time. |
Methods inherited from class java.util.TimeZone |
getAvailableIDs,
getAvailableIDs,
getDefault,
getDisplayName,
getDisplayName,
getDisplayName,
getDisplayName,
getID,
getTimeZone,
setDefault,
setID |
Methods inherited from class java.lang.Object |
finalize,
getClass,
notify,
notifyAll,
wait,
wait,
wait |
Constructor Detail |
public SimpleTimeZone(int rawOffset, String ID)
rawOffset
- The given base time zone offset to GMT.ID
- The time zone ID which is obtained from
TimeZone.getAvailableIDs.public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime)
rawOffset
- The given base time zone offset to GMT.ID
- The time zone ID which is obtained from
TimeZone.getAvailableIDs.startMonth
- The daylight savings starting month. Month is
0-based. eg, 0 for January.startDay
- The daylight savings starting
day-of-week-in-month. Please see the member
description for an example.startDayOfWeek
- The daylight savings starting day-of-week. Please
see the member description for an example.startTime
- The daylight savings starting time in local wall
time, which is standard time in this case. Please see the
member description for an example.endMonth
- The daylight savings ending month. Month is
0-based. eg, 0 for January.endDay
- The daylight savings ending day-of-week-in-month.
Please see the member description for an example.endDayOfWeek
- The daylight savings ending day-of-week. Please
see the member description for an example.endTime
- The daylight savings ending time in local wall time,
which is daylight time in this case. Please see the
member description for an example.public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)
dstSavings
- The amount of time in ms saved during DST.Method Detail |
public void setStartYear(int year)
year
- The daylight savings starting year.public void setStartRule(int month, int dayOfWeekInMonth, int dayOfWeek, int time)
month
- The daylight savings starting month. Month is
0-based. eg, 0 for January.dayOfWeekInMonth
- The daylight savings starting
day-of-week-in-month. Please see the member
description for an example.dayOfWeek
- The daylight savings starting day-of-week.
Please see the member description for an
example.time
- The daylight savings starting time in local wall
time, which is standard time in this case. Please see
the member description for an example.public void setStartRule(int month, int dayOfMonth, int time)
month
- The month in which this rule occurs (0-based).dayOfMonth
- The date in that month (1-based).time
- The time of that day (number of millis after midnight)
when DST takes effect in local wall time, which is
standard time in this case.public void setStartRule(int month, int dayOfMonth, int dayOfWeek, int time, boolean after)
month
- The month in which this rule occurs (0-based).dayOfMonth
- A date within that month (1-based).dayOfWeek
- The day of the week on which this rule occurs.time
- The time of that day (number of millis after midnight)
when DST takes effect in local wall time, which is
standard time in this case.after
- If true, this rule selects the first dayOfWeek on
or after dayOfMonth. If false, this rule selects
the last dayOfWeek on or before dayOfMonth.public void setEndRule(int month, int dayOfWeekInMonth, int dayOfWeek, int time)
month
- The daylight savings ending month. Month is
0-based. eg, 0 for January.dayOfWeekInMonth
- The daylight savings ending
day-of-week-in-month. Please see the member
description for an example.dayOfWeek
- The daylight savings ending day-of-week. Please
see the member description for an example.time
- The daylight savings ending time in local wall time,
which is daylight time in this case. Please see the
member description for an example.public void setEndRule(int month, int dayOfMonth, int time)
month
- The month in which this rule occurs (0-based).dayOfMonth
- The date in that month (1-based).time
- The time of that day (number of millis after midnight)
when DST ends in local wall time, which is daylight
time in this case.public void setEndRule(int month, int dayOfMonth, int dayOfWeek, int time, boolean after)
month
- The month in which this rule occurs (0-based).dayOfMonth
- A date within that month (1-based).dayOfWeek
- The day of the week on which this rule occurs.time
- The time of that day (number of millis after midnight)
when DST ends in local wall time, which is daylight
time in this case.after
- If true, this rule selects the first dayOfWeek on
or after dayOfMonth. If false, this rule selects
the last dayOfWeek on or before dayOfMonth.public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)
Gregorian Calendar
object as its
underlying calendar, such as for determining leap years. Do
not use the result of this method with a calendar other than a
default GregorianCalendar
.
Note: In general, clients should use
Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET)
instead of calling this method.
getOffset
in class
TimeZone
era
- The era of the given date.year
- The year in the given date.month
- The month
in the given date. Month is 0-based. e.g.,
0 for January.day
- The day-in-month of the given date.dayOfWeek
- The day-of-week of the given date.millis
- The milliseconds in day in standard local time.IllegalArgumentException
- the era, month, day,
dayOfWeek, or millis parameters are out of rangepublic int getRawOffset()
public void setRawOffset(int offsetMillis)
offsetMillis
- the given base time zone offset to GMT.public void setDSTSavings(int millisSavedDuringDST)
millisSavedDuringDST
- the number of milliseconds the time is
advanced with respect to standard time when the daylight savings rules
are in effect. A positive number, typically one hour (3600000).public int getDSTSavings()
public boolean useDaylightTime()
public boolean inDaylightTime(Date date)
date
- the given Date.public Object clone()
Cloneable
interface. Subclasses
that override the clone
method can also
throw this exception to indicate that an instance cannot
be cloned.Cloneable
public int hashCode()
Object.equals(java.lang.Object)
,
Hashtable
public boolean equals(Object obj)
obj
- The SimpleTimeZone object to be compared with.public boolean hasSameRules(TimeZone other)
other
- the TimeZone object to be compared withpublic String toString()
|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |