|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.icu.util.TimeZone
com.ibm.icu.util.BasicTimeZone
public abstract class BasicTimeZone
BasicTimeZone
is an abstract class extending TimeZone
.
This class provides some additional methods to access time zone transitions
and rules. All ICU TimeZone
concrete subclasses extend this
class.
TimeZoneRule
,
TimeZoneTransition
,
Serialized FormField 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 |
---|
LONG, SHORT, TIMEZONE_ICU, TIMEZONE_JDK |
Constructor Summary | |
---|---|
protected |
BasicTimeZone()
Protected no arg constructor. |
Method Summary | |
---|---|
abstract TimeZoneTransition |
getNextTransition(long base,
boolean inclusive)
Gets 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)
Gets the last time zone transition before the base time. |
TimeZoneRule[] |
getSimpleTimeZoneRulesNear(long date)
Gets the array of TimeZoneRule which represents the rule of
this time zone object near the specified date. |
abstract TimeZoneRule[] |
getTimeZoneRules()
Gets the array of TimeZoneRule which represents the rule
of this time zone object. |
TimeZoneRule[] |
getTimeZoneRules(long start)
Gets 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)
Checks if the time zone has equivalent transitions in the time range. |
boolean |
hasEquivalentTransitions(TimeZone tz,
long start,
long end,
boolean ignoreDstAmount)
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, getCanonicalID, getCanonicalID, getDefault, getDefaultTimeZoneType, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDSTSavings, getEquivalentID, getID, getOffset, getOffset, getOffset, getRawOffset, 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 |