java.util

Class TimeZone

java.lang.Object

java.util.TimeZone

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

SimpleTimeZone

public abstract class TimeZone
extends Object
implements Cloneable

Constructor Summary

Constructors

Constructor and Description
TimeZone() Timezone object constructor.

Method Summary

Modifier and Type	Method and Description
Object	clone() Creates a copy of this TimeZone.
static String[]	getAvailableIDs() Gets all the available IDs supported.
static String[]	getAvailableIDs(int offset) Gets the available IDs according to the given time zone offset in milliseconds.
static TimeZone	getDefault() Gets the default TimeZone for this JNIOR.
String	getID() Returns the time zone ID.
abstract int	getOffset(int era, int year, int month, int day, int dow, int tod) Gets the time zone offset, for current date, modified in case of daylight savings.
abstract int	getRawOffset() Returns the amount of time in milliseconds to add to UTC to get standard time in this time zone.
static TimeZone	getTimeZone(String abbr) Gets the TimeZone for the given ID.
abstract boolean	inDaylightTime(Date date) Queries if the given date is in Daylight Saving Time in this time zone.
static void	setDefault(TimeZone timezone) Sets the TimeZone that is returned by the getDefault method.
void	setID(String id) Sets the time zone ID.
abstract void	setRawOffset(int ofs) Sets the base time zone offset to UTC.
abstract boolean	useDaylightTime() Queries if this TimeZone uses Daylight Saving Time.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TimeZone

public TimeZone()

Timezone object constructor.

Method Detail

clone

public Object clone()
             throws CloneNotSupportedException

Creates a copy of this TimeZone.

Overrides:

clone in class Object

Returns:

clone of this object

Throws:

CloneNotSupportedException - if not supported

See Also:

Cloneable

getAvailableIDs

public static String[] getAvailableIDs()

Gets all the available IDs supported.

Returns:

array of identifiers

getAvailableIDs

public static String[] getAvailableIDs(int offset)

Gets the available IDs according to the given time zone offset in milliseconds.

Parameters:

offset - the offset from UTC

Returns:

an array of identifiers, where the time zone for that ID has the specified UTC offset.

getDefault

public static TimeZone getDefault()

Gets the default TimeZone for this JNIOR.

Returns:

the default TimeZone

getID

public String getID()

Returns the time zone ID.

Returns:

TimeZone identifier

getOffset

public abstract int getOffset(int era,
                              int year,
                              int month,
                              int day,
                              int dow,
                              int tod)

Gets the time zone offset, for current date, modified in case of daylight savings. This is the offset to add to UTC to get local time.

Parameters:

era - the era of the given date

year - the year of the given date

month - the month in the given date (0-based, e.g. January is 0)

day - the day of the month in the given date

dow - the day of the week in the given date

tod - the time of the day in milliseconds in standard local time

Returns:

the offset in milliseconds (add to GMT to get local time)

getRawOffset

public abstract int getRawOffset()

Returns the amount of time in milliseconds to add to UTC to get standard time in this time zone. Does not consider Daylight Savings Time.

Returns:

offset in milliseconds to add to UTC

getTimeZone

public static TimeZone getTimeZone(String abbr)

Gets the TimeZone for the given ID.

Parameters:

abbr - the ID for a TimeZone

Returns:

the specified TimeZone, or UTC

inDaylightTime

public abstract boolean inDaylightTime(Date date)

Queries if the given date is in Daylight Saving Time in this time zone.

Parameters:

date - a date

Returns:

true if the given date is in Daylight Saving Time, false otherwise.

setDefault

public static void setDefault(TimeZone timezone)

Sets the TimeZone that is returned by the getDefault method.

Parameters:

timezone - new default TimeZone

setID

public void setID(String id)

Sets the time zone ID.

Parameters:

id - new ID

setRawOffset

public abstract void setRawOffset(int ofs)

Sets the base time zone offset to UTC. This is the offset to add to UTC to get local time.

Parameters:

ofs - offset in milliseconds from UTC

useDaylightTime

public abstract boolean useDaylightTime()

Queries if this TimeZone uses Daylight Saving Time.

Returns:

true if this TimeZone uses Daylight Savings Time