public class JavaTimeZone extends TimeZone
TimeZone.SystemTimeZoneTypeGENERIC_LOCATION, GMT_ZONE, LONG, LONG_GENERIC, LONG_GMT, SHORT, SHORT_COMMONLY_USED, SHORT_GENERIC, SHORT_GMT, TIMEZONE_ICU, TIMEZONE_JDK, UNKNOWN_ZONE, UNKNOWN_ZONE_ID| Constructor and Description |
|---|
JavaTimeZone()
Constructs a JavaTimeZone with the default Java TimeZone
|
JavaTimeZone(TimeZone jtz,
String id)
Constructs a JavaTimeZone with the specified Java TimeZone and ID.
|
| Modifier and Type | Method and Description |
|---|---|
Object |
clone()
Overrides clone.
|
TimeZone |
cloneAsThawed()
Provides for the clone operation.
|
static JavaTimeZone |
createTimeZone(String id)
Creates an instance of JavaTimeZone with the given timezone ID.
|
TimeZone |
freeze()
Freezes the object.
|
int |
getDSTSavings()
Returns the amount of time to be added to local standard time
to get local wall clock time.
|
int |
getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int milliseconds)
Gets the time zone offset, for current date, modified in case of
daylight savings.
|
void |
getOffset(long date,
boolean local,
int[] offsets)
Returns the time zone raw and GMT offset for the given moment
in time.
|
int |
getRawOffset()
Gets unmodified offset, NOT modified in case of daylight savings.
|
int |
hashCode()
Overrides hashCode.
|
boolean |
inDaylightTime(Date date)
Queries if the given date is in daylight savings time in
this time zone.
|
boolean |
isFrozen()
Determines whether the object has been frozen or not.
|
boolean |
observesDaylightTime()
Queries if this time zone is in daylight saving time or will observe
daylight saving time at any future time.
|
void |
setRawOffset(int offsetMillis)
Sets the base time zone offset to GMT.
|
TimeZone |
unwrap() |
boolean |
useDaylightTime()
Queries if this time zone uses daylight savings time.
|
countEquivalentIDs, equals, getAvailableIDs, getAvailableIDs, getAvailableIDs, getAvailableIDs, getCanonicalID, getCanonicalID, getDefault, getDefaultTimeZoneType, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getEquivalentID, getFrozenTimeZone, getID, getIDForWindowsID, getOffset, getRegion, getTimeZone, getTimeZone, getTZDataVersion, getWindowsID, hasSameRules, setDefault, setDefaultTimeZoneType, setIDpublic JavaTimeZone()
public static JavaTimeZone createTimeZone(String id)
id - A timezone ID, either a system ID or a custom ID.public int getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int milliseconds)
TimeZonegetOffset in class TimeZoneera - 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.milliseconds - the millis in day in standard local time.public void getOffset(long date,
boolean local,
int[] offsets)
TimeZonegetOffset in class TimeZonedate - moment in time for which to return offsets, in
units of milliseconds from January 1, 1970 0:00 GMT, either GMT
time or local wall time, depending on `local'.local - if true, `date' is local wall time; otherwise it
is in GMT time.offsets - output parameter to receive the raw offset, that
is, the offset not including DST adjustments, in offsets[0],
and the DST offset, that is, the offset to be added to
`rawOffset' to obtain the total offset between local and GMT
time, in offsets[1]. If DST is not in effect, the DST offset is
zero; otherwise it is a positive value, typically one hour.public int getRawOffset()
TimeZonegetRawOffset in class TimeZonepublic boolean inDaylightTime(Date date)
TimeZoneinDaylightTime in class TimeZonedate - the given Date.public void setRawOffset(int offsetMillis)
TimeZonesetRawOffset in class TimeZoneoffsetMillis - the given base time zone offset to GMT.public boolean useDaylightTime()
TimeZoneuseDaylightTime in class TimeZoneNote:The default implementation of
ICU TimeZone uses the tz database, which supports historic
rule changes, for system time zones. With the implementation,
there are time zones that used daylight savings time in the
past, but no longer used currently. For example, Asia/Tokyo has
never used daylight savings time since 1951. Most clients would
expect that this method to return false for such case.
The default implementation of this method returns true
when the time zone uses daylight savings time in the current
(Gregorian) calendar year.
public boolean observesDaylightTime()
TimeZoneThe default implementation in this class returns true if TimeZone.useDaylightTime()
or inDaylightTime(new Date()) returns true.
Note: This method was added for JDK compatibility support.
The JDK's useDaylightTime() only checks the last known rule(s), therefore
it may return false even the zone observes daylight saving time currently. JDK added
observesDaylightTime() to resolve the issue. In ICU, TimeZone.useDaylightTime()
works differently. The ICU implementation checks if the zone uses daylight saving time
in the current calendar year. Therefore, it will never return false if
daylight saving time is currently used.
ICU's TimeZone subclass implementations override this method to support the same behavior
with JDK's observesDaylightSavingTime(). Unlike TimeZone.useDaylightTime(),
the implementation does not take past daylight saving time into account, so
that this method may return false even when TimeZone.useDaylightTime() returns
true.
observesDaylightTime in class TimeZonetrue if this time zone is in daylight saving time or will observe
daylight saving time at any future time.TimeZone.useDaylightTime()public int getDSTSavings()
TimeZoneThe default implementation always returns 3600000 milliseconds (i.e., one hour) if this time zone observes Daylight Saving Time. Otherwise, 0 (zero) is returned.
If an underlying TimeZone implementation subclass supports historical Daylight Saving Time changes, this method returns the known latest daylight saving value.
getDSTSavings in class TimeZonepublic TimeZone unwrap()
public int hashCode()
TimeZonehashCode in class TimeZoneObject.equals(java.lang.Object)public boolean isFrozen()
TimeZonepublic TimeZone cloneAsThawed()
TimeZonecloneAsThawed in interface Freezable<TimeZone>cloneAsThawed in class TimeZone