| java.lang.Object
 java.util.TimeZone
All known Subclasses: sun.util.calendar.ZoneInfo, java.util.SimpleTimeZone,
| TimeZone | | abstract public class TimeZone (Code) | | 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 Pacific
Standard Time zone is "PST". So, you can get a PST TimeZone object
with:
TimeZone tz = TimeZone.getTimeZone("PST");
This class is a pure subset of the java.util.TimeZone class in JDK 1.3.
The only time zone ID that is required to be supported is "GMT".
Apart from the methods and variables being subset, the semantics of the
getTimeZone() method may also be subset: custom IDs such as "GMT-8:00"
are not required to be supported.
See Also: java.util.Calendar
See Also: java.util.Date
version:
CLDC 1.1 02/01/2002 (Based on JDK 1.3) |
| Method Summary | |
| public static String[] | getAvailableIDs()
Gets all the available IDs supported. | | public static synchronized TimeZone | getDefault()
Gets the default TimeZone for this host. | | public String | getID()
Gets the ID of this time zone. | | abstract public int | getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)
Gets offset, for current date, modified in case of
daylight savings. | | abstract public int | getRawOffset()
Gets the GMT offset for this time zone. | | public static synchronized TimeZone | getTimeZone(String ID)
Gets the TimeZone for the given ID.
Parameters:
ID - the ID for a TimeZone, either an abbreviation such as"GMT", or a full name such as "America/Los_Angeles". The only time zone ID that is required to be supported is "GMT". | | abstract public boolean | useDaylightTime()
Queries if this time zone uses Daylight Savings Time. |
| TimeZone | | public TimeZone()(Code) | | |
| getAvailableIDs | | public static String[] getAvailableIDs()(Code) | | Gets all the available IDs supported.
an array of IDs. |
| getDefault | | public static synchronized TimeZone getDefault()(Code) | | Gets the default TimeZone for this host.
The source of the default TimeZone
may vary with implementation.
a default TimeZone. |
| getID | | public String getID()(Code) | | Gets the ID of this time zone.
the ID of this time zone. |
| getOffset | | abstract public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)(Code) | | Gets offset, for current date, modified in case of
daylight savings. This is the offset to add *to* GMT to get local time.
Gets the time zone offset, for current date, modified in case of daylight
savings. This is the offset to add *to* GMT to get local time. Assume
that the start and end month are distinct. This method may return incorrect
results for rules that start at the end of February (e.g., last Sunday in
February) or the beginning of March (e.g., March 1).
Parameters:
era - The era of the given date (0 = BC, 1 = AD).
Parameters:
year - The year in the given date.
Parameters:
month - The month in the given date. Month is 0-based. e.g.,0 for January.
Parameters:
day - The day-in-month of the given date.
Parameters:
dayOfWeek - The day-of-week of the given date.
Parameters:
millis - The milliseconds in day in standard local time. The offset to add *to* GMT to get local time.
exception:
IllegalArgumentException - the era, month, day,dayOfWeek, or millis parameters are out of range |
| getRawOffset | | abstract public int getRawOffset()(Code) | | Gets the GMT offset for this time zone.
the GMT offset for this time zone. |
| getTimeZone | | public static synchronized TimeZone getTimeZone(String ID)(Code) | | Gets the TimeZone for the given ID.
Parameters:
ID - the ID for a TimeZone, either an abbreviation such as"GMT", or a full name such as "America/Los_Angeles". The only time zone ID that is required to be supported is "GMT". the specified TimeZone, or the GMT zone if the given ID cannot beunderstood. |
| useDaylightTime | | abstract public boolean useDaylightTime()(Code) | | Queries if this time zone uses Daylight Savings Time.
if this time zone uses Daylight Savings Time. |
|
|