|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.ibm.icu.util.TimeZone com.ibm.icu.util.BasicTimeZone
public abstract class BasicTimeZone
[icu] BasicTimeZone extends TimeZone
with additional methods to access
time zone transitions and rules. All ICU TimeZone
concrete subclasses
extend this class. APIs added to java.util.TimeZone
by
BasicTimeZone
are annotated with '[icu]'.
TimeZoneRule
,
TimeZoneTransition
,
Serialized FormNested Class Summary |
---|
Nested classes/interfaces inherited from class com.ibm.icu.util.TimeZone |
---|
TimeZone.SystemTimeZoneType |
Field Summary | |
---|---|
protected static int |
FORMER_LATTER_MASK
Deprecated. This API is ICU internal only. |
static int |
LOCAL_DST
Deprecated. This API is ICU internal only. |
static int |
LOCAL_FORMER
Deprecated. This API is ICU internal only. |
static int |
LOCAL_LATTER
Deprecated. This API is ICU internal only. |
static int |
LOCAL_STD
Deprecated. This API is ICU internal only. |
protected static int |
STD_DST_MASK
Deprecated. This API is ICU internal only. |
Fields inherited from class com.ibm.icu.util.TimeZone |
---|
GENERIC_LOCATION, LONG, LONG_GENERIC, LONG_GMT, SHORT, SHORT_COMMONLY_USED, SHORT_GENERIC, SHORT_GMT, TIMEZONE_ICU, TIMEZONE_JDK, TimeZoneLogger, UNKNOWN_ZONE_ID |
Constructor Summary | |
---|---|
protected |
BasicTimeZone()
Protected no arg constructor. |
Method Summary | |
---|---|
abstract TimeZoneTransition |
getNextTransition(long base,
boolean inclusive)
[icu] Returns the first time zone transition after the base time. |
void |
getOffsetFromLocal(long date,
int nonExistingTimeOpt,
int duplicatedTimeOpt,
int[] offsets)
Deprecated. This API is ICU internal only. |
abstract TimeZoneTransition |
getPreviousTransition(long base,
boolean inclusive)
[icu] Returns the last time zone transition before the base time. |
TimeZoneRule[] |
getSimpleTimeZoneRulesNear(long date)
[icu] Returns the array of TimeZoneRule which represents the rule of
this time zone object near the specified date. |
abstract TimeZoneRule[] |
getTimeZoneRules()
[icu] Returns the array of TimeZoneRule which represents the rule
of this time zone object. |
TimeZoneRule[] |
getTimeZoneRules(long start)
[icu] Returns the array of TimeZoneRule which represents the rule
of this time zone object since the specified start time. |
boolean |
hasEquivalentTransitions(TimeZone tz,
long start,
long end)
[icu] Checks if the time zone has equivalent transitions in the time range. |
boolean |
hasEquivalentTransitions(TimeZone tz,
long start,
long end,
boolean ignoreDstAmount)
[icu] Checks if the time zone has equivalent transitions in the time range. |
Methods inherited from class com.ibm.icu.util.TimeZone |
---|
clone, countEquivalentIDs, equals, getAvailableIDs, getAvailableIDs, getAvailableIDs, getAvailableIDs, getCanonicalID, getCanonicalID, getDefault, getDefaultTimeZoneType, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDSTSavings, getEquivalentID, getID, getOffset, getOffset, getOffset, getRawOffset, getRegion, getTimeZone, getTimeZone, getTZDataVersion, hashCode, hasSameRules, inDaylightTime, setDefault, setDefaultTimeZoneType, setID, setRawOffset, useDaylightTime |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int LOCAL_STD
getOffsetFromLocal(long, int, int, int[])
public static final int LOCAL_DST
getOffsetFromLocal(long, int, int, int[])
public static final int LOCAL_FORMER
getOffsetFromLocal(long, int, int, int[])
public static final int LOCAL_LATTER
getOffsetFromLocal(long, int, int, int[])
protected static final int STD_DST_MASK
getOffsetFromLocal(long, int, int, int[])
protected static final int FORMER_LATTER_MASK
getOffsetFromLocal(long, int, int, int[])
Constructor Detail |
---|
protected BasicTimeZone()
Method Detail |
---|
public abstract TimeZoneTransition getNextTransition(long base, boolean inclusive)
base
- The base time.inclusive
- Whether the base time is inclusive or not.
Date
holding the first time zone transition time
after the given base time, or null if no time zone transitions
are available after the base time.public abstract TimeZoneTransition getPreviousTransition(long base, boolean inclusive)
base
- The base time.inclusive
- Whether the base time is inclusive or not.
Date
holding the last time zone transition time
before the given base time, or null if no time zone transitions
are available before the base time.public boolean hasEquivalentTransitions(TimeZone tz, long start, long end)
tz
- The instance of TimeZone
start
- The start time of the evaluated time range (inclusive)end
- The end time of the evaluated time range (inclusive)
BasicTimeZone
, this method
returns false.public boolean hasEquivalentTransitions(TimeZone tz, long start, long end, boolean ignoreDstAmount)
tz
- The instance of TimeZone
start
- The start time of the evaluated time range (inclusive)end
- The end time of the evaluated time range (inclusive)ignoreDstAmount
- When true, any transitions with only daylight saving amount
changes will be ignored, except either of them is zero. For example, a transition
from rawoffset 3:00/dstsavings 1:00 to rawoffset 2:00/dstsavings 2:00 is excluded
from the comparison, but a transtion from rawoffset 2:00/dstsavings 1:00 to
rawoffset 3:00/dstsavings 0:00 is included.
BasicTimeZone
, this method
returns false.public abstract TimeZoneRule[] getTimeZoneRules()
TimeZoneRule
which represents the rule
of this time zone object. The first element in the result array will
be the InitialTimeZoneRule
instance for the initial rule.
The rest will be either AnnualTimeZoneRule
or
TimeArrayTimeZoneRule
instances representing transitions.
TimeZoneRule
which represents this
time zone.public TimeZoneRule[] getTimeZoneRules(long start)
TimeZoneRule
which represents the rule
of this time zone object since the specified start time. The first
element in the result array will be the InitialTimeZoneRule
instance for the initial rule. The rest will be either
AnnualTimeZoneRule
or TimeArrayTimeZoneRule
instances representing transitions.
start
- The start time (inclusive).
TimeZoneRule
which represents this
time zone since the start time.public TimeZoneRule[] getSimpleTimeZoneRulesNear(long date)
TimeZoneRule
which represents the rule of
this time zone object near the specified date. Some applications are not
capable to handle historic time zone rule changes. Also some applications
can only handle certain type of rule definitions. This method returns
either a single InitialTimeZoneRule
if this time zone does not
have any daylight saving time within 1 year from the specified time, or a
pair of AnnualTimeZoneRule
whose rule type is
DateTimeRule.DOW
for date and DateTimeRule.WALL_TIME
for time with a single InitialTimeZoneRule
representing the
initial time, when this time zone observes daylight saving time near the
specified date. Thus, the result may be only valid for dates around the
specified date.
date
- The date to be used for TimeZoneRule
extraction.
TimeZoneRule
, either a single
InitialTimeZoneRule
object, or a pair of AnnualTimeZoneRule
with a single InitialTimeZoneRule
. The first element in the
array is always a InitialTimeZoneRule
.public void getOffsetFromLocal(long date, int nonExistingTimeOpt, int duplicatedTimeOpt, int[] offsets)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |