Class ZoneInfo

public ZoneInfo(int rawOffset,
                String id,
                long[] transitions,
                SimpleTimeZone lastRule)

Create a ZoneInfo with the given time offset from GMT and with daylight savings.

Parameters:

rawOffset - The time offset from GMT in milliseconds.

id - The identifier of this time zone.

transitions - Array of transition times in UTC seconds since Epoch in topmost 42 bits, below that 1 boolean bit whether the time before that transition used daylight saving and in bottommost 21 bits relative daylight saving offset against rawOffset in seconds that applies before this transition.

public boolean equals(Object o)

Determine whether this Object is semantically equal to another Object.

There are some fairly strict requirements on this method which subclasses must follow:

• It must be transitive. If a.equals(b) and b.equals(c), then a.equals(c) must be true as well.
• It must be symmetric. a.equals(b) and b.equals(a) must have the same value.
• It must be reflexive. a.equals(a) must always be true.
• It must be consistent. Whichever value a.equals(b) returns on the first invocation must be the value returned on all later invocations.
• a.equals(null) must be false.
• It must be consistent with hashCode(). That is, a.equals(b) must imply a.hashCode() == b.hashCode(). The reverse is not true; two objects that are not equal may have the same hashcode, but that has the potential to harm hashing performance.

This is typically overridden to throw a ClassCastException if the argument is not comparable to the class performing the comparison, but that is not a requirement. It is legal for a.equals(b) to be true even though a.getClass() != b.getClass(). Also, it is typical to never cause a NullPointerException.

In general, the Collections API (java.util) use the equals method rather than the == operator to compare objects. However, IdentityHashMap is an exception to this rule, for its own good reasons.

The default implementation returns this == o.

Overrides:

equals in interface Object

Parameters:

Returns:

whether this Object is semantically equal to another

See Also:

Object.hashCode()

public int getDSTSavings()

Gets the daylight savings offset. This is a positive offset in milliseconds with respect to standard time. Typically this is one hour, but for some time zones this may be half an our.

Overrides:

getDSTSavings in interface TimeZone

Returns:

the daylight savings offset in milliseconds.

public int getOffset(int era,
                     int year,
                     int month,
                     int day,
                     int dayOfWeek,
                     int millis)

Gets the time zone offset, for current date, modified in case of daylight savings. This is the offset to add to UTC to get the local time. The day must be a positive number and dayOfWeek must be a positive value from Calendar. dayOfWeek is redundant, but must match the other values or an inaccurate result may be returned.

Overrides:

getOffset in interface TimeZone

Parameters:

era - the era of the given date

year - the year of the given date

month - the month of the given date, 0 for January.

day - the day of month

dayOfWeek - the day of week; this must match the other fields.

millis - the millis in the day (in local standard time)

Returns:

the time zone offset in milliseconds.

Throws:

IllegalArgumentException - if arguments are incorrect.

public int getOffset(long date)

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

Overrides:

getOffset in interface TimeZone

Parameters:

date - the date represented in millisecends since January 1, 1970 00:00:00 GMT.

public int getRawOffset()

Returns the time zone offset to GMT in milliseconds, ignoring day light savings.

Overrides:

getRawOffset in interface TimeZone

Returns:

the time zone offset.

public boolean hasSameRules(TimeZone o)

Test if the other time zone uses the same rule and only possibly differs in ID. This implementation for this particular class will return true if the other object is a ZoneInfo, the raw offsets and useDaylight are identical and if useDaylight is true, also the start and end datas are identical.

Overrides:

hasSameRules in interface TimeZone

Returns:

true if this zone uses the same rule.

public int hashCode()

Generates the hashCode for the SimpleDateFormat object. It is the rawOffset, possibly, if useDaylightSavings is true, xored with startYear, startMonth, startDayOfWeekInMonth, ..., endTime.

Overrides:

hashCode in interface Object

public boolean inDaylightTime(Date date)

Determines if the given date is in daylight savings time.

Overrides:

inDaylightTime in interface TimeZone

Returns:

true, if it is in daylight savings time, false otherwise.

public static TimeZone readTZFile(String id,
                                  String file)

Reads zic(8) compiled timezone data file from file and returns a TimeZone class describing it, either SimpleTimeZone or ZoneInfo depending on whether it can be described by SimpleTimeZone rule or not.

public void setRawOffset(int rawOffset)

Sets the standard time zone offset to GMT.

Overrides:

setRawOffset in interface TimeZone

Parameters:

rawOffset - The time offset from GMT in milliseconds.

public String toString()

Returns a string representation of this ZoneInfo object.

Overrides:

toString in interface Object

Returns:

a string representation of this ZoneInfo object.

public boolean useDaylightTime()

Returns if this time zone uses daylight savings time.

Overrides:

useDaylightTime in interface TimeZone

Returns:

true, if we use daylight savings time, false otherwise.