java.util TimeZone

java.util
TimeZone

Declaration
public abstract class TimeZone
java.lang.Object
|
+--java.util.TimeZone
Description
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.


Constructors
TimeZone()
Methods
static
java.lang.String
getAvailableIDs()
static TimeZone getDefault()
java.lang.String getID()
abstract int getOffset(int era, int year, int month, int day, int
dayOfWeek, int millis)
abstract int getRawOffset()
static TimeZone getTimeZone(java.lang.String ID)
abstract boolean useDaylightTime()



Methods inherited from class Object
equals(Object), getClass(), hashCode(), notify(), notifyAll(), toString(), wait(),
wait(), wait()




Constructors
TimeZone()
Declaration:
public TimeZone()
Methods
getOffset(int, int, int, int, int, int)
Declaration:
public abstract int getOffset(int era, int year, int month, int day, int dayOfWeek,
int millis)
Description:
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).
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.
millis - The milliseconds in day in standard local time.
Returns: The offset to add *to* GMT to get local time.
Throws:
java.lang.IllegalArgumentException - the era, month, day, dayOfWeek, or millis
parameters are out of range
getRawOffset()
Declaration:
public abstract int getRawOffset()
Description:
Gets the GMT offset for this time zone.



useDaylightTime()

Returns: the GMT offset for this time zone.
useDaylightTime()
Declaration:
public abstract boolean useDaylightTime()
Description:
Queries if this time zone uses Daylight Savings Time.
Returns: if this time zone uses Daylight Savings Time.
getID()
Declaration:
public java.lang.String getID()
Description:
Gets the ID of this time zone.
Returns: the ID of this time zone.
getTimeZone(String)
Declaration:
public static java.util.TimeZone getTimeZone(java.lang.String ID)
Description:
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”.
Returns: the specified TimeZone, or the GMT zone if the given ID cannot be understood.
getDefault()
Declaration:
public static java.util.TimeZone getDefault()
Description:
Gets the default TimeZone for this host. The source of the default TimeZone may vary with
implementation.
Returns: a default TimeZone.
getAvailableIDs()
Declaration:
public static java.lang.String[] getAvailableIDs()
Description:
Gets all the available IDs supported.
Returns: an array of IDs.