SimpleTimeZone is a concrete subclass of TimeZone
that represents a time zone for use with a Gregorian
calendar. This simple class does not handle historical
changes, and has limited rules.
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.
Overrides TimeZone
Queries if this time zone uses Daylight Savings Time.
SimpleTimeZone
public SimpleTimeZone(int rawOffset,
String ID)
Constructs a SimpleTimeZone with the given base time zone offset
from GMT and time zone ID. Timezone IDs can be obtained from
TimeZone.getAvailableIDs. Normally you should use TimeZone.getDefault
to construct a TimeZone.
Parameters:
rawOffset - the given base time zone offset to GMT.
ID - the time zone ID which is obtained from
TimeZone.getAvailableIDs.
SimpleTimeZone
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDayOfWeekInMonth,
int startDayOfWeek,
int startTime,
int endMonth,
int endDayOfWeekInMonth,
int endDayOfWeek,
int endTime)
Constructs a SimpleTimeZone with the given base time zone offset
from GMT, time zone ID, time to start and end the daylight time.
Timezone IDs can be obtained from TimeZone.getAvailableIDs.
Normally you should use TimeZone.getDefault to create a TimeZone.
For a time zone that does not use daylight saving time, do not
use this constructor; instead you should use
SimpleTimeZone(rawOffset, ID).
Parameters:
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.
startDayOfWeekInMonth - 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. Please see the
member description for an example.
endMonth - the daylight savings ending month. Month is 0-based.
eg, 0 for January.
endDayOfWeekInMonth - 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. Please see the member
description for an example.
setStartRule
public void setStartRule(int month,
int dayOfWeekInMonth,
int dayOfWeek,
int time)
Sets the daylight savings starting rule. For example, Daylight Savings
Time starts at the first Sunday in April, at 2 AM in standard time.
Therefore, you can set the start rule by calling:
setStartRule(TimeFields.APRIL, 1, TimeFields.SUNDAY, 2*60*60*1000);
Parameters:
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. Please see the member
description for an example.
setEndRule
public void setEndRule(int month,
int dayOfWeekInMonth,
int dayOfWeek,
int time)
Sets the daylight savings ending rule. For example, Daylight Savings
Time ends at the last (-1) Sunday in October, at 2 AM in standard time.
Therefore, you can set the end rule by calling:
setEndRule(TimeFields.OCTOBER, -1, TimeFields.SUNDAY, 2*60*60*1000);
Parameters:
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. Please see the member
description for an example.
getOffset
public int getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int millis)
Overrides TimeZone
Gets the time zone offset, for current date, modified in case of
daylight savings. This is the offset to add *to* UTC to get local time.
Please see TimeZone.getOffset for descriptions of parameters.
setRawOffset
public void setRawOffset(int offsetMillis)
Overrides TimeZone
Sets the base time zone offset to GMT.
This is the offset to add *to* UTC to get local time.
Please see TimeZone.setRawOffset for descriptions on the parameter.