danger.internal
Class TimeZone

java.lang.Object
  danger.internal.TimeZone

All Implemented Interfaces:

SystemStrings

Deprecated. This class was not meant to be publicly accessible. It will be removed in a future OS release.

public class TimeZone
extends Object
implements SystemStrings

Field Summary

static int	FLAG_IS_GMT_OFFSET Deprecated.
static int	FLAG_USE_DST Deprecated.
static int	ID_ALASKA Deprecated.
static int	ID_ALEUTIAN Deprecated.
static int	ID_ARIZONA Deprecated.
static int	ID_ATLANTIC Deprecated.
static int	ID_ATLANTIC_PUERTO_RICO Deprecated.
static int	ID_CENTRAL Deprecated.
static int	ID_EASTERN Deprecated.
static int	ID_GMT Deprecated.
static int	ID_GMT_MINUS1 Deprecated.
static int	ID_GMT_MINUS10 Deprecated.
static int	ID_GMT_MINUS11 Deprecated.
static int	ID_GMT_MINUS12 Deprecated.
static int	ID_GMT_MINUS2 Deprecated.
static int	ID_GMT_MINUS3 Deprecated.
static int	ID_GMT_MINUS3_BRASILIA Deprecated.
static int	ID_GMT_MINUS3_GREENLAND Deprecated.
static int	ID_GMT_MINUS330_NEWFOUNDLAND Deprecated.
static int	ID_GMT_MINUS4 Deprecated.
static int	ID_GMT_MINUS4_CHILE Deprecated.
static int	ID_GMT_MINUS5 Deprecated.
static int	ID_GMT_MINUS6 Deprecated.
static int	ID_GMT_MINUS6_EASTER Deprecated.
static int	ID_GMT_MINUS6_SASKATCHEWAN Deprecated.
static int	ID_GMT_MINUS7 Deprecated.
static int	ID_GMT_MINUS8 Deprecated.
static int	ID_GMT_MINUS9 Deprecated.
static int	ID_GMT_PLUS1 Deprecated.
static int	ID_GMT_PLUS1_CENTRAL_EUROPE Deprecated.
static int	ID_GMT_PLUS1_NAMIBIA Deprecated.
static int	ID_GMT_PLUS10 Deprecated.
static int	ID_GMT_PLUS10_CANBERRA Deprecated.
static int	ID_GMT_PLUS10_GUAM Deprecated.
static int	ID_GMT_PLUS10_TASMANIA Deprecated.
static int	ID_GMT_PLUS10_VLADIVOSTOK Deprecated.
static int	ID_GMT_PLUS1030_LORD_HOWE Deprecated.
static int	ID_GMT_PLUS11 Deprecated.
static int	ID_GMT_PLUS11_MAGADAN Deprecated.
static int	ID_GMT_PLUS12 Deprecated.
static int	ID_GMT_PLUS12_KAMCHATKA Deprecated.
static int	ID_GMT_PLUS12_NZ Deprecated.
static int	ID_GMT_PLUS1245_CHATHAM Deprecated.
static int	ID_GMT_PLUS13 Deprecated.
static int	ID_GMT_PLUS2 Deprecated.
static int	ID_GMT_PLUS2_EASTERN_EUROPE Deprecated.
static int	ID_GMT_PLUS2_EGYPT Deprecated.
static int	ID_GMT_PLUS2_ISRAEL Deprecated.
static int	ID_GMT_PLUS3 Deprecated.
static int	ID_GMT_PLUS3_IRAQ Deprecated.
static int	ID_GMT_PLUS3_MOSCOW Deprecated.
static int	ID_GMT_PLUS3_NAIROBI Deprecated.
static int	ID_GMT_PLUS330_IRAN Deprecated.
static int	ID_GMT_PLUS4 Deprecated.
static int	ID_GMT_PLUS4_BAKU Deprecated.
static int	ID_GMT_PLUS4_VICTORIA Deprecated.
static int	ID_GMT_PLUS430_AFGHANISTAN Deprecated.
static int	ID_GMT_PLUS5 Deprecated.
static int	ID_GMT_PLUS5_EKATERINBURG Deprecated.
static int	ID_GMT_PLUS5_ISLAMABAD Deprecated.
static int	ID_GMT_PLUS530_INDIA Deprecated.
static int	ID_GMT_PLUS545_KATHMANDU Deprecated.
static int	ID_GMT_PLUS6 Deprecated.
static int	ID_GMT_PLUS6_ALMATY Deprecated.
static int	ID_GMT_PLUS630_RANGOON Deprecated.
static int	ID_GMT_PLUS7 Deprecated.
static int	ID_GMT_PLUS7_KRASNOYARSK Deprecated.
static int	ID_GMT_PLUS8 Deprecated.
static int	ID_GMT_PLUS8_IRKUTSK Deprecated.
static int	ID_GMT_PLUS8_PERTH Deprecated.
static int	ID_GMT_PLUS9 Deprecated.
static int	ID_GMT_PLUS9_YAKUTSK Deprecated.
static int	ID_GMT_PLUS930_ADELAIDE Deprecated.
static int	ID_GMT_PLUS930_DARWIN Deprecated.
static int	ID_GMT_UK Deprecated.
static int	ID_GMT_WESTERN_EUROPE Deprecated.
static int	ID_HAWAII Deprecated.
static int	ID_INDIANA_EAST Deprecated.
static int	ID_INVALID Deprecated.
static int	ID_MOUNTAIN Deprecated.
static int	ID_PACIFIC Deprecated.
static int	ID_SAMOA Deprecated.

Fields inherited from interface danger.SystemStrings

ID_CANCEL, ID_DONE, ID_NEXT, ID_PREVIOUS

Method Summary

static int	getCount() Deprecated. Returns the number of supported time zones, not including invisible time zones
static int	getCountIncludingInvisibleZones() Deprecated. Returns the number of supported time zones, including invisible time zones
static TimeZone	getDefault() Deprecated. Return the default time zone.
String	getDisplayName() Deprecated. Returns the name of this TimeZone suitable for user display.
int	getID() Deprecated. Returns the ID of this TimeZone.
TimeZone	getJavaTimeZone() Deprecated. Returns the java time zone
int	getOffset() Deprecated. Returns the offset from GMT NOT adjusted for daylight savings time.
int	getOffset(long millis) Deprecated. Returns this time zone's offset from GMT (in seconds) at a particular moment in time (expressed as the number of milliseconds since 12:00 am GMT, January 1, 1970).
String	getOffsetDisplayName() Deprecated. Returns the offset display name, in -0800 format
static TimeZone	getTimeZone(int inID) Deprecated. Returns the time zone corresponding to the specified ID.
static TimeZone	getTimeZoneAt(int inIndex) Deprecated. Returns the time zone corresponding to the specified index
static TimeZone	getTimeZoneFromGMTOffset(int inOffset) Deprecated. Returns the time zone corresponding to the given GMT offset or null if there is no available time zone with that offset.
static TimeZone	getTimeZoneFromQuarterHourGMTOffset(int inOffset, long millis) Deprecated. Returns the time zone corresponding to the given GMT offset at the given point in time, or null if there is no available time zone with that offset for that point in time.
static void	hasBeenRestored() Deprecated. This method is called by SysApp when the time zone setting is received from the service.
boolean	inDaylightTime(long millis) Deprecated. Returns whether the given scalar time (expressed as the number of milliseconds since 12:00 am GMT, January 1, 1970) is in daylight time.
static void	init() Deprecated. This method is called by SysApp when the system is starting up.
boolean	isGMTOffset() Deprecated. Returns whether this time zone is a pure GMT offset (as opposed to a region of the Earth, where the laws regarding timekeeping may change from time to time).
static TimeZone	newFromJavaTimeZone(TimeZone inTZ) Deprecated. Create a Danger time zone corresponding to a Java time zone.
static void	setDefault(int inID) Deprecated. Set the default time zone.
static void	setDefault(TimeZone inTZ) Deprecated. Set the default time zone.
static void	setGMTOffset(int inOffsetHours) Deprecated. Set the default time zone via GMT offset.
boolean	useDaylightTime() Deprecated. Returns whether this time zone uses daylight savings time.

Methods inherited from class java.lang.Object

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

Field Detail

FLAG_USE_DST

public static final int FLAG_USE_DST

Deprecated.

See Also:

Constant Field Values

FLAG_IS_GMT_OFFSET

public static final int FLAG_IS_GMT_OFFSET

Deprecated.

See Also:

Constant Field Values

ID_INVALID

public static final int ID_INVALID

Deprecated.

See Also:

Constant Field Values

ID_ATLANTIC

public static final int ID_ATLANTIC

Deprecated.

See Also:

Constant Field Values

ID_EASTERN

public static final int ID_EASTERN

Deprecated.

See Also:

Constant Field Values

ID_CENTRAL

public static final int ID_CENTRAL

Deprecated.

See Also:

Constant Field Values

ID_MOUNTAIN

public static final int ID_MOUNTAIN

Deprecated.

See Also:

Constant Field Values

ID_PACIFIC

public static final int ID_PACIFIC

Deprecated.

See Also:

Constant Field Values

ID_ALASKA

public static final int ID_ALASKA

Deprecated.

See Also:

Constant Field Values

ID_ALEUTIAN

public static final int ID_ALEUTIAN

Deprecated.

See Also:

Constant Field Values

ID_ARIZONA

public static final int ID_ARIZONA

Deprecated.

See Also:

Constant Field Values

ID_INDIANA_EAST

public static final int ID_INDIANA_EAST

Deprecated.

See Also:

Constant Field Values

ID_HAWAII

public static final int ID_HAWAII

Deprecated.

See Also:

Constant Field Values

ID_SAMOA

public static final int ID_SAMOA

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS12

public static final int ID_GMT_MINUS12

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS11

public static final int ID_GMT_MINUS11

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS10

public static final int ID_GMT_MINUS10

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS9

public static final int ID_GMT_MINUS9

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS8

public static final int ID_GMT_MINUS8

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS7

public static final int ID_GMT_MINUS7

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS6

public static final int ID_GMT_MINUS6

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS5

public static final int ID_GMT_MINUS5

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS4

public static final int ID_GMT_MINUS4

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS3

public static final int ID_GMT_MINUS3

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS2

public static final int ID_GMT_MINUS2

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS1

public static final int ID_GMT_MINUS1

Deprecated.

See Also:

Constant Field Values

ID_GMT

public static final int ID_GMT

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS1

public static final int ID_GMT_PLUS1

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS2

public static final int ID_GMT_PLUS2

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS3

public static final int ID_GMT_PLUS3

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS4

public static final int ID_GMT_PLUS4

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS5

public static final int ID_GMT_PLUS5

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS6

public static final int ID_GMT_PLUS6

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS7

public static final int ID_GMT_PLUS7

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS8

public static final int ID_GMT_PLUS8

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS9

public static final int ID_GMT_PLUS9

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS10

public static final int ID_GMT_PLUS10

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS11

public static final int ID_GMT_PLUS11

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS12

public static final int ID_GMT_PLUS12

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS13

public static final int ID_GMT_PLUS13

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS4_CHILE

public static final int ID_GMT_MINUS4_CHILE

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS330_NEWFOUNDLAND

public static final int ID_GMT_MINUS330_NEWFOUNDLAND

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS3_BRASILIA

public static final int ID_GMT_MINUS3_BRASILIA

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS3_GREENLAND

public static final int ID_GMT_MINUS3_GREENLAND

Deprecated.

See Also:

Constant Field Values

ID_GMT_UK

public static final int ID_GMT_UK

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS1_CENTRAL_EUROPE

public static final int ID_GMT_PLUS1_CENTRAL_EUROPE

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS2_EASTERN_EUROPE

public static final int ID_GMT_PLUS2_EASTERN_EUROPE

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS2_EGYPT

public static final int ID_GMT_PLUS2_EGYPT

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS2_ISRAEL

public static final int ID_GMT_PLUS2_ISRAEL

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS3_IRAQ

public static final int ID_GMT_PLUS3_IRAQ

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS3_MOSCOW

public static final int ID_GMT_PLUS3_MOSCOW

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS330_IRAN

public static final int ID_GMT_PLUS330_IRAN

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS4_BAKU

public static final int ID_GMT_PLUS4_BAKU

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS430_AFGHANISTAN

public static final int ID_GMT_PLUS430_AFGHANISTAN

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS5_EKATERINBURG

public static final int ID_GMT_PLUS5_EKATERINBURG

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS5_ISLAMABAD

public static final int ID_GMT_PLUS5_ISLAMABAD

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS530_INDIA

public static final int ID_GMT_PLUS530_INDIA

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS545_KATHMANDU

public static final int ID_GMT_PLUS545_KATHMANDU

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS6_ALMATY

public static final int ID_GMT_PLUS6_ALMATY

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS630_RANGOON

public static final int ID_GMT_PLUS630_RANGOON

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS7_KRASNOYARSK

public static final int ID_GMT_PLUS7_KRASNOYARSK

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS8_IRKUTSK

public static final int ID_GMT_PLUS8_IRKUTSK

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS9_YAKUTSK

public static final int ID_GMT_PLUS9_YAKUTSK

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS930_ADELAIDE

public static final int ID_GMT_PLUS930_ADELAIDE

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS930_DARWIN

public static final int ID_GMT_PLUS930_DARWIN

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS10_CANBERRA

public static final int ID_GMT_PLUS10_CANBERRA

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS10_TASMANIA

public static final int ID_GMT_PLUS10_TASMANIA

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS10_VLADIVOSTOK

public static final int ID_GMT_PLUS10_VLADIVOSTOK

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS11_MAGADAN

public static final int ID_GMT_PLUS11_MAGADAN

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS12_NZ

public static final int ID_GMT_PLUS12_NZ

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS12_KAMCHATKA

public static final int ID_GMT_PLUS12_KAMCHATKA

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS6_SASKATCHEWAN

public static final int ID_GMT_MINUS6_SASKATCHEWAN

Deprecated.

See Also:

Constant Field Values

ID_GMT_MINUS6_EASTER

public static final int ID_GMT_MINUS6_EASTER

Deprecated.

See Also:

Constant Field Values

ID_GMT_WESTERN_EUROPE

public static final int ID_GMT_WESTERN_EUROPE

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS1_NAMIBIA

public static final int ID_GMT_PLUS1_NAMIBIA

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS3_NAIROBI

public static final int ID_GMT_PLUS3_NAIROBI

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS4_VICTORIA

public static final int ID_GMT_PLUS4_VICTORIA

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS8_PERTH

public static final int ID_GMT_PLUS8_PERTH

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS10_GUAM

public static final int ID_GMT_PLUS10_GUAM

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS1030_LORD_HOWE

public static final int ID_GMT_PLUS1030_LORD_HOWE

Deprecated.

See Also:

Constant Field Values

ID_ATLANTIC_PUERTO_RICO

public static final int ID_ATLANTIC_PUERTO_RICO

Deprecated.

See Also:

Constant Field Values

ID_GMT_PLUS1245_CHATHAM

public static final int ID_GMT_PLUS1245_CHATHAM

Deprecated.

See Also:

Constant Field Values

Method Detail

newFromJavaTimeZone

public static TimeZone newFromJavaTimeZone(TimeZone inTZ)

Deprecated.

Create a Danger time zone corresponding to a Java time zone. The ID of the Danger time zone will be invalid so it is unsuitable for use with setDefault(int).

In release 2.4 and earlier of the Danger software, time zones created this way would have the FLAG_IS_GMT_OFFSET flag set, even though this is inappropriate for most Java time zones.

init

public static void init()

Deprecated.

This method is called by SysApp when the system is starting up. Do not call it yourself.

hasBeenRestored

public static void hasBeenRestored()

Deprecated.

This method is called by SysApp when the time zone setting is received from the service. Do not call it yourself.

getID

public int getID()

Deprecated.

Returns the ID of this TimeZone.

getDisplayName

public String getDisplayName()

Deprecated.

Returns the name of this TimeZone suitable for user display.

getOffset

public int getOffset()

Deprecated.

Returns the offset from GMT NOT adjusted for daylight savings time.

getOffsetDisplayName

public String getOffsetDisplayName()

Deprecated.

Returns the offset display name, in -0800 format

getOffset

public int getOffset(long millis)

Deprecated.

Returns this time zone's offset from GMT (in seconds) at a particular moment in time (expressed as the number of milliseconds since 12:00 am GMT, January 1, 1970).

getJavaTimeZone

public TimeZone getJavaTimeZone()

Deprecated.

Returns the java time zone

useDaylightTime

public boolean useDaylightTime()

Deprecated.

Returns whether this time zone uses daylight savings time.

inDaylightTime

public boolean inDaylightTime(long millis)

Deprecated.

Returns whether the given scalar time (expressed as the number of milliseconds since 12:00 am GMT, January 1, 1970) is in daylight time.

isGMTOffset

public boolean isGMTOffset()

Deprecated.

Returns whether this time zone is a pure GMT offset (as opposed to a region of the Earth, where the laws regarding timekeeping may change from time to time).

getTimeZone

public static TimeZone getTimeZone(int inID)

Deprecated.

Returns the time zone corresponding to the specified ID.

Note that for historical reasons, certain ID arguments to this method will actually return a TimeZone with a different ID:

 ID_GMT_MINUS11 -> ID_SAMOA
 ID_GMT_MINUS10 -> ID_HAWAII
 ID_GMT_MINUS9 -> ID_ALASKA
 ID_GMT_MINUS8 -> ID_PACIFIC
 ID_GMT_MINUS7 -> ID_ARIZONA
 ID_GMT_PLUS5 -> ID_GMT_PLUS5_EKATERINBURG
 ID_GMT_PLUS11 -> ID_GMT_PLUS11_MAGADAN
 

So if you need to be sure that you get exactly the ID you want, iterate through the zone list yourself with getTimeZoneAt(int) and check the ID of each one yourself.

Parameters:

inID - ID of the requested TimeZone

getTimeZoneAt

public static TimeZone getTimeZoneAt(int inIndex)

Deprecated.

Returns the time zone corresponding to the specified index

Parameters:

inIndex - zero based index

getTimeZoneFromGMTOffset

public static TimeZone getTimeZoneFromGMTOffset(int inOffset)

Deprecated.

Returns the time zone corresponding to the given GMT offset or null if there is no available time zone with that offset.

Parameters:

inOffset - GMT offset in hours

Returns:

the timezone corresponding to inOffset, or null if no timezone matches

getTimeZoneFromQuarterHourGMTOffset

public static TimeZone getTimeZoneFromQuarterHourGMTOffset(int inOffset,
                                                           long millis)

Deprecated.

Returns the time zone corresponding to the given GMT offset at the given point in time, or null if there is no available time zone with that offset for that point in time. Unlike getTimeZoneFromGMTOffset(int), this method prefers North American timezones (Pacific, Mountain, Central, Eastern) to generic GMT offset timezones, which is why we require the second parameter in order to determine whether or not DST is active.

Parameters:

inOffset - GMT offset in fifteen-minute increments

millis - the time for which inOffset is valid, expressed as the number of milliseconds since 12:00 am GMT, January 1, 1970

Returns:

the timezone corresponding to inOffset and millis, or null if no timezone matches

getCount

public static int getCount()

Deprecated.

Returns the number of supported time zones, not including invisible time zones

getCountIncludingInvisibleZones

public static int getCountIncludingInvisibleZones()

Deprecated.

Returns the number of supported time zones, including invisible time zones

getDefault

public static TimeZone getDefault()

Deprecated.

Return the default time zone.

setDefault

public static void setDefault(int inID)

Deprecated.

Set the default time zone. This also calls java.util.TimeZone.setDefault(), but (bug alert) beware that in releases prior to 2.3, it calls it with the wrong value in many cases, so the return value from java.util.TimeZone.getDefault() cannot be trusted in these earlier releases.

Parameters:

inID - ID representing the TimeZone

setDefault

public static void setDefault(TimeZone inTZ)

Deprecated.

Set the default time zone. This also calls java.util.TimeZone.setDefault(), but (bug alert) beware that in releases prior to 2.3, it calls it with the wrong value in many cases, so the return value from java.util.TimeZone.getDefault() cannot be trusted in these earlier releases.

setGMTOffset

public static void setGMTOffset(int inOffsetHours)

Deprecated.

Set the default time zone via GMT offset.