| java.lang.Object
 com.ibm.icu.util.TimeZone
com.ibm.icu.impl.JDKTimeZone
com.ibm.icu.util.SimpleTimeZone
| SimpleTimeZone | | public class SimpleTimeZone extends JDKTimeZone (Code) | | 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.
See Also: Calendar
See Also: GregorianCalendar
See Also: TimeZone
author:
David Goldsmith, Mark Davis, Chen-Lieh Huang, Alan Liu |
| Constructor Summary | |
| public | SimpleTimeZone(int rawOffset, String ID)
Constructs a SimpleTimeZone with the given base time zone offset from GMT
and time zone ID. | | public | 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. | | public | SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)
Constructor. | | public | SimpleTimeZone(java.util.SimpleTimeZone tz, String ID)
Constructs a SimpleTimeZone that wraps the given
java.util.SimpleTimeZone. | | public | SimpleTimeZone(int raw, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int startTimeMode, int endMonth, int endDay, int endDayOfWeek, int endTime, int endTimeMode, int dst)
|
| Method Summary | |
| public Object | clone()
Return a clone of this time zone. | | public boolean | equals(Object obj)
Return true if obj is a SimpleTimeZone equivalent to this. | | public int | getDSTSavings()
Returns the amount of time in ms that the clock is advanced during DST.
the number of milliseconds the time isadvanced with respect to standard time when the daylight savings rulesare in effect. | | public int | getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)
| | public int | getOffset(int era, int year, int month, int day, int dayOfWeek, int millis, int monthLength)
| | int | getOffset(int era, int year, int month, int day, int dayOfWeek, int millis, int monthLength, int prevMonthLength)
| | public int | getRawOffset()
get the raw offset. | | public boolean | hasSameRules(TimeZone othr)
| | public int | hashCode()
Return the hash code. | | public boolean | inDaylightTime(Date date)
| | public void | setDSTSavings(int millisSavedDuringDST)
Sets the amount of time in ms that the clock is advanced during DST.
Parameters:
millisSavedDuringDST - the number of milliseconds the time isadvanced with respect to standard time when the daylight savings rulesare in effect. | | public void | setEndRule(int month, int dayOfWeekInMonth, int dayOfWeek, int time)
Sets the daylight savings ending rule. | | public void | setEndRule(int month, int dayOfMonth, int time)
Sets the DST end rule to a fixed date within a month. | | public 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.
Parameters:
month - The month in which this rule occurs (0-based).
Parameters:
dayOfMonth - A date within that month (1-based).
Parameters:
dayOfWeek - The day of the week on which this rule occurs.
Parameters:
time - The time of that day (number of millis after midnight)when DST ends in local wall time, which is daylighttime in this case.
Parameters:
after - If true, this rule selects the first dayOfWeek onor after dayOfMonth. | | public void | setRawOffset(int offsetMillis)
Set the raw offset. | | public void | setStartRule(int month, int dayOfWeekInMonth, int dayOfWeek, int time)
Sets the daylight savings starting rule. | | public void | setStartRule(int month, int dayOfMonth, int time)
Sets the DST start rule to a fixed date within a month. | | public 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.
Parameters:
month - The month in which this rule occurs (0-based).
Parameters:
dayOfMonth - A date within that month (1-based).
Parameters:
dayOfWeek - The day of the week on which this rule occurs.
Parameters:
time - The time of that day (number of millis after midnight)when DST takes effect in local wall time, which isstandard time in this case.
Parameters:
after - If true, this rule selects the first dayOfWeek onor after dayOfMonth. | | public void | setStartYear(int year)
Sets the daylight savings starting year. | | public String | toString()
Returns a string representation of this object. | | public boolean | useDaylightTime()
|
| SimpleTimeZone | | public SimpleTimeZone(int rawOffset, String ID)(Code) | | 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.
Parameters:
ID - The time zone ID which is obtained fromTimeZone.getAvailableIDs. |
| SimpleTimeZone | | public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime)(Code) | | Construct 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).
By default, this constructor specifies day-of-week-in-month rules. That
is, if the startDay is 1, and the startDayOfWeek is SUNDAY, then this
indicates the first Sunday in the startMonth. A startDay of -1 likewise
indicates the last Sunday. However, by using negative or zero values for
certain parameters, other types of rules can be specified.
Day of month. To specify an exact day of the month, such as March 1, set
startDayOfWeek to zero.
Day of week after day of month. To specify the first day of the week
occurring on or after an exact day of the month, make the day of the week
negative. For example, if startDay is 5 and startDayOfWeek is -MONDAY,
this indicates the first Monday on or after the 5th day of the
startMonth.
Day of week before day of month. To specify the last day of the week
occurring on or before an exact day of the month, make the day of the
week and the day of the month negative. For example, if startDay is -21
and startDayOfWeek is -WEDNESDAY, this indicates the last Wednesday on or
before the 21st of the startMonth.
The above examples refer to the startMonth, startDay, and startDayOfWeek;
the same applies for the endMonth, endDay, and endDayOfWeek.
Parameters:
rawOffset - The given base time zone offset to GMT.
Parameters:
ID - The time zone ID which is obtained fromTimeZone.getAvailableIDs.
Parameters:
startMonth - The daylight savings starting month. Month is0-based. eg, 0 for January.
Parameters:
startDay - The daylight savings startingday-of-week-in-month. Please see the memberdescription for an example.
Parameters:
startDayOfWeek - The daylight savings starting day-of-week. Pleasesee the member description for an example.
Parameters:
startTime - The daylight savings starting time in local walltime, which is standard time in this case. Please see themember description for an example.
Parameters:
endMonth - The daylight savings ending month. Month is0-based. eg, 0 for January.
Parameters:
endDay - The daylight savings ending day-of-week-in-month.Please see the member description for an example.
Parameters:
endDayOfWeek - The daylight savings ending day-of-week. Pleasesee the member description for an example.
Parameters:
endTime - The daylight savings ending time in local wall time,which is daylight time in this case. Please see themember description for an example.
exception:
IllegalArgumentException - the month, day, dayOfWeek, or timeparameters are out of range for the start or end rule |
| SimpleTimeZone | | public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)(Code) | | Constructor. This constructor is identical to the 10-argument
constructor, but also takes a dstSavings parameter.
Parameters:
dstSavings - The amount of time in ms saved during DST.
exception:
IllegalArgumentException - the month, day, dayOfWeek, or timeparameters are out of range for the start or end rule |
| SimpleTimeZone | | public SimpleTimeZone(java.util.SimpleTimeZone tz, String ID)(Code) | | Constructs a SimpleTimeZone that wraps the given
java.util.SimpleTimeZone. Do not call; use the TimeZone
API.
|
| SimpleTimeZone | | public SimpleTimeZone(int raw, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int startTimeMode, int endMonth, int endDay, int endDayOfWeek, int endTime, int endTimeMode, int dst)(Code) | | |
| clone | | public Object clone()(Code) | | Return a clone of this time zone.
a clone of this time zone |
| equals | | public boolean equals(Object obj)(Code) | | Return true if obj is a SimpleTimeZone equivalent to this.
true if obj is a SimpleTimeZone equivalent to this |
| getDSTSavings | | public int getDSTSavings()(Code) | | Returns the amount of time in ms that the clock is advanced during DST.
the number of milliseconds the time isadvanced with respect to standard time when the daylight savings rulesare in effect. A positive number, typically one hour (3600000). |
| getOffset | | public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)(Code) | | |
| getOffset | | public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis, int monthLength)(Code) | | |
| getOffset | | int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis, int monthLength, int prevMonthLength)(Code) | | |
| getRawOffset | | public int getRawOffset()(Code) | | get the raw offset.
the raw offset |
| hashCode | | public int hashCode()(Code) | | Return the hash code.
the hash code |
| inDaylightTime | | public boolean inDaylightTime(Date date)(Code) | | |
| setDSTSavings | | public void setDSTSavings(int millisSavedDuringDST)(Code) | | Sets the amount of time in ms that the clock is advanced during DST.
Parameters:
millisSavedDuringDST - the number of milliseconds the time isadvanced with respect to standard time when the daylight savings rulesare in effect. A positive number, typically one hour (3600000). |
| setEndRule | | public void setEndRule(int month, int dayOfWeekInMonth, int dayOfWeek, int time)(Code) | | 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 is0-based. eg, 0 for January.
Parameters:
dayOfWeekInMonth - The daylight savings endingday-of-week-in-month. Please see the memberdescription for an example.
Parameters:
dayOfWeek - The daylight savings ending day-of-week. Pleasesee the member description for an example.
Parameters:
time - The daylight savings ending time in local wall time,which is daylight time in this case. Please see themember description for an example.
exception:
IllegalArgumentException - the month, dayOfWeekInMonth,dayOfWeek, or time parameters are out of range |
| setEndRule | | public void setEndRule(int month, int dayOfMonth, int time)(Code) | | Sets the DST end rule to a fixed date within a month.
Parameters:
month - The month in which this rule occurs (0-based).
Parameters:
dayOfMonth - The date in that month (1-based).
Parameters:
time - The time of that day (number of millis after midnight)when DST ends in local wall time, which is daylighttime in this case.
exception:
IllegalArgumentException - the month,dayOfMonth, or time parameters are out of range |
| setEndRule | | public void setEndRule(int month, int dayOfMonth, int dayOfWeek, int time, boolean after)(Code) | | 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.
Parameters:
month - The month in which this rule occurs (0-based).
Parameters:
dayOfMonth - A date within that month (1-based).
Parameters:
dayOfWeek - The day of the week on which this rule occurs.
Parameters:
time - The time of that day (number of millis after midnight)when DST ends in local wall time, which is daylighttime in this case.
Parameters:
after - If true, this rule selects the first dayOfWeek onor after dayOfMonth. If false, this rule selectsthe last dayOfWeek on or before dayOfMonth.
exception:
IllegalArgumentException - the month, dayOfMonth,dayOfWeek, or time parameters are out of range |
| setRawOffset | | public void setRawOffset(int offsetMillis)(Code) | | Set the raw offset.
Parameters:
offsetMillis - the raw offset of the time zone |
| setStartRule | | public void setStartRule(int month, int dayOfWeekInMonth, int dayOfWeek, int time)(Code) | | 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 is0-based. eg, 0 for January.
Parameters:
dayOfWeekInMonth - The daylight savings startingday-of-week-in-month. Please see the memberdescription for an example.
Parameters:
dayOfWeek - The daylight savings starting day-of-week.Please see the member description for anexample.
Parameters:
time - The daylight savings starting time in local walltime, which is standard time in this case. Please seethe member description for an example.
exception:
IllegalArgumentException - the month, dayOfWeekInMonth,dayOfWeek, or time parameters are out of range |
| setStartRule | | public void setStartRule(int month, int dayOfMonth, int time)(Code) | | Sets the DST start rule to a fixed date within a month.
Parameters:
month - The month in which this rule occurs (0-based).
Parameters:
dayOfMonth - The date in that month (1-based).
Parameters:
time - The time of that day (number of millis after midnight)when DST takes effect in local wall time, which isstandard time in this case.
exception:
IllegalArgumentException - the month,dayOfMonth, or time parameters are out of range |
| setStartRule | | public void setStartRule(int month, int dayOfMonth, int dayOfWeek, int time, boolean after)(Code) | | 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.
Parameters:
month - The month in which this rule occurs (0-based).
Parameters:
dayOfMonth - A date within that month (1-based).
Parameters:
dayOfWeek - The day of the week on which this rule occurs.
Parameters:
time - The time of that day (number of millis after midnight)when DST takes effect in local wall time, which isstandard time in this case.
Parameters:
after - If true, this rule selects the first dayOfWeek onor after dayOfMonth. If false, this rule selectsthe last dayOfWeek on or before dayOfMonth.
exception:
IllegalArgumentException - the month, dayOfMonth,dayOfWeek, or time parameters are out of range |
| setStartYear | | public void setStartYear(int year)(Code) | | Sets the daylight savings starting year.
Parameters:
year - The daylight savings starting year. |
| toString | | public String toString()(Code) | | Returns a string representation of this object.
a string representation of this object |
| useDaylightTime | | public boolean useDaylightTime()(Code) | | |
| Methods inherited from com.ibm.icu.util.TimeZone | public Object clone()(Code)(Java Doc)
static void computeGregorianFields(long day, int fields)(Code)(Java Doc)
public static int countEquivalentIDs(String id)(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
static long floorDivide(long numerator, long denominator)(Code)(Java Doc)
static int floorDivide(long numerator, int denominator, int[] remainder)(Code)(Java Doc)
public static String[] getAvailableIDs(int rawOffset)(Code)(Java Doc)
public static String[] getAvailableIDs(String country)(Code)(Java Doc)
public static String[] getAvailableIDs()(Code)(Java Doc)
public int getDSTSavings()(Code)(Java Doc)
public static synchronized TimeZone getDefault()(Code)(Java Doc)
final public String getDisplayName()(Code)(Java Doc)
final public String getDisplayName(Locale locale)(Code)(Java Doc)
final public String getDisplayName(ULocale locale)(Code)(Java Doc)
final public String getDisplayName(boolean daylight, int style)(Code)(Java Doc)
public String getDisplayName(boolean daylight, int style, Locale locale)(Code)(Java Doc)
public String getDisplayName(boolean daylight, int style, ULocale locale)(Code)(Java Doc)
public static String getEquivalentID(String id, int index)(Code)(Java Doc)
public String getID()(Code)(Java Doc)
abstract public int getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)(Code)(Java Doc)
public int getOffset(long date)(Code)(Java Doc)
public void getOffset(long date, boolean local, int[] offsets)(Code)(Java Doc)
abstract public int getRawOffset()(Code)(Java Doc)
public static synchronized TimeZone getTimeZone(String ID)(Code)(Java Doc)
public boolean hasSameRules(TimeZone other)(Code)(Java Doc)
public int hashCode()(Code)(Java Doc)
abstract public boolean inDaylightTime(Date date)(Code)(Java Doc)
public static synchronized void setDefault(TimeZone tz)(Code)(Java Doc)
public void setID(String ID)(Code)(Java Doc)
abstract public void setRawOffset(int offsetMillis)(Code)(Java Doc)
abstract public boolean useDaylightTime()(Code)(Java Doc)
|
|
|