|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.util.TimeZone
TimeZone
represents a time zone offset, and also figures out daylight
savings.
Typically, you get a TimeZone
using getDefault
which creates a TimeZone
based on the time zone where the program
is running. For example, for a program running in Japan, getDefault
creates a TimeZone
object based on Japanese Standard Time.
You can also get a TimeZone
using getTimeZone
along with a time zone ID. For instance, the time zone ID for the
U.S. Pacific Time zone is "America/Los_Angeles". So, you can get a
U.S. Pacific Time TimeZone
object with:
You can useTimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");
getAvailableIDs
method to iterate through
all the supported time zone IDs. You can then choose a
supported ID to get a TimeZone
.
If the time zone you want is not represented by one of the
supported IDs, then you can create a custom time zone ID with
the following syntax:
For example, you might specify GMT+14:00 as a custom time zone ID. TheGMT[+|-]hh[[:]mm]
TimeZone
that is returned
when you specify a custom time zone ID does not include
daylight savings time.
For compatibility with JDK 1.1.x, some other three-letter time zone IDs (such as "PST", "CTT", "AST") are also supported. However, their use is deprecated because the same abbreviation is often used for multiple time zones (for example, "CST" could be U.S. "Central Standard Time" and "China Standard Time"), and the Java platform can then only recognize one of them.
Calendar
,
GregorianCalendar
,
SimpleTimeZone
, Serialized FormField Summary | |
static int |
LONG
A style specifier for getDisplayName() indicating
a long name, such as "Pacific Standard Time." |
static int |
SHORT
A style specifier for getDisplayName() indicating
a short name, such as "PST." |
Constructor Summary | |
TimeZone()
Sole constructor. |
Method Summary | |
java.lang.Object |
clone()
Overrides Cloneable |
static int |
countEquivalentIDs(java.lang.String id)
Returns the number of IDs in the equivalency group that includes the given ID. |
static java.lang.String[] |
getAvailableIDs()
Return a new String array containing all system TimeZone IDs. |
static java.lang.String[] |
getAvailableIDs(int rawOffset)
Return a new String array containing all system TimeZone IDs with the given raw offset from GMT. |
static java.lang.String[] |
getAvailableIDs(java.lang.String country)
Return a new String array containing all system TimeZone IDs associated with the given country. |
static TimeZone |
getDefault()
Gets the default TimeZone for this host. |
java.lang.String |
getDisplayName()
Returns a name of this time zone suitable for presentation to the user in the default locale. |
java.lang.String |
getDisplayName(boolean daylight,
int style)
Returns a name of this time zone suitable for presentation to the user in the default locale. |
java.lang.String |
getDisplayName(boolean daylight,
int style,
java.util.Locale locale)
Returns a name of this time zone suitable for presentation to the user in the specified locale. |
java.lang.String |
getDisplayName(java.util.Locale locale)
Returns a name of this time zone suitable for presentation to the user in the specified locale. |
static java.lang.String |
getEquivalentID(java.lang.String id,
int index)
Returns an ID in the equivalency group that includes the given ID. |
java.lang.String |
getID()
Gets the ID of this time zone. |
abstract 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. |
abstract int |
getRawOffset()
Gets unmodified offset, NOT modified in case of daylight savings. |
static TimeZone |
getTimeZone(java.lang.String ID)
Gets the TimeZone for the given ID. |
boolean |
hasSameRules(TimeZone other)
Returns true if this zone has the same rule and offset as another zone. |
abstract boolean |
inDaylightTime(java.util.Date date)
Queries if the given date is in daylight savings time in this time zone. |
static void |
setDefault(TimeZone zone)
Sets the TimeZone that is
returned by the getDefault method. |
void |
setID(java.lang.String ID)
Sets the time zone ID. |
abstract void |
setRawOffset(int offsetMillis)
Sets the base time zone offset to GMT. |
abstract boolean |
useDaylightTime()
Queries if this time zone uses daylight savings time. |
Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int SHORT
getDisplayName()
indicating
a short name, such as "PST."LONG
public static final int LONG
getDisplayName()
indicating
a long name, such as "Pacific Standard Time."SHORT
Constructor Detail |
public TimeZone()
Method Detail |
public abstract int getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)
era
- 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 abstract void setRawOffset(int offsetMillis)
offsetMillis
- the given base time zone offset to GMT.public abstract int getRawOffset()
public java.lang.String getID()
public void setID(java.lang.String ID)
ID
- the new time zone ID.public final java.lang.String getDisplayName()
GMT[+-]hh:mm
.public final java.lang.String getDisplayName(java.util.Locale locale)
GMT[+-]hh:mm
.locale
- the locale in which to supply the display name.public final java.lang.String getDisplayName(boolean daylight, int style)
GMT[+-]hh:mm
.daylight
- if true, return the daylight savings name.style
- either LONG
or SHORT
public java.lang.String getDisplayName(boolean daylight, int style, java.util.Locale locale)
GMT[+-]hh:mm
.daylight
- if true, return the daylight savings name.style
- either LONG
or SHORT
locale
- the locale in which to supply the display name.java.lang.IllegalArgumentException
- style is invalid.public abstract boolean useDaylightTime()
public abstract boolean inDaylightTime(java.util.Date date)
date
- the given Date.public static TimeZone getTimeZone(java.lang.String ID)
TimeZone
for the given ID.ID
- the ID for a TimeZone
, either an abbreviation
such as "PST", a full name such as "America/Los_Angeles", or a custom
ID such as "GMT-8:00". Note that the support of abbreviations is
for JDK 1.1.x compatibility only and full names should be used.TimeZone
, or the GMT zone if the given ID
cannot be understood.public static java.lang.String[] getAvailableIDs(int rawOffset)
get()
to construct the corresponding TimeZone
object.rawOffset
- the offset in milliseconds from GMTpublic static java.lang.String[] getAvailableIDs(java.lang.String country)
get()
to construct the corresponding TimeZone
object.a
- two-letter ISO 3166 country code, or null
to return zones not associated with any countrypublic static java.lang.String[] getAvailableIDs()
get()
to construct the corresponding TimeZone
object.public static int countEquivalentIDs(java.lang.String id)
The returned count includes the given ID; it is always >= 1 for valid IDs. The given ID must be a system time zone. If it is not, returns zero.
id
- a system time zone IDgetEquivalentID(java.lang.String, int)
public static java.lang.String getEquivalentID(java.lang.String id, int index)
The given index must be in the range 0..n-1, where n is the
value returned by countEquivalentIDs(id)
. For
some value of 'index', the returned value will be equal to the
given id. If the given id is not a valid system time zone, or
if 'index' is out of range, then returns an empty string.
id
- a system time zone IDindex
- a value from 0 to n-1, where n is the value
returned by countEquivalentIDs(id)
countEquivalentIDs(java.lang.String)
public static TimeZone getDefault()
TimeZone
for this host.
The source of the default TimeZone
may vary with implementation.TimeZone
.public static void setDefault(TimeZone zone)
TimeZone
that is
returned by the getDefault
method. If zone
is null, reset the default to the value it had originally when the
VM first started.zone
- the new default time zonepublic boolean hasSameRules(TimeZone other)
other
- the TimeZone
object to be compared withpublic java.lang.Object clone()
clone
in class java.lang.Object
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |