eve.sys

Class TZifTimeZone

java.lang.Object

java.util.TimeZone

eve.sys.TZifTimeZone

All Implemented Interfaces:

Serializable, Cloneable

public class TZifTimeZone
extends TimeZone

This class implements a TimeZone from a Linux TZif formatted timezone file.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.TimeZone

LONG, SHORT

Constructor Summary

Constructors

Constructor and Description
TZifTimeZone(String fullName, byte[] src, int offset, int length) Create a TZifTimeZone from the bytes of a TZif file.

Method Summary

Modifier and Type	Method and Description
static TZifTimeZone	fromFile(String fullName, File src) A convenience method to create a TZifTimeZone from a File source.
String	getDisplayName(boolean dst, int style, Locale locale) This method returns a string name of the time zone suitable for displaying to the user.
int	getDSTSavings() Return the most up-to-date Daylight Savings Time change in milliseconds.
int	getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds) Gets the time zone offset, for current date, modified in case of daylight savings.
int	getRawOffset() Gets the time zone offset, ignoring daylight savings.
boolean	inDaylightTime(Date date) Returns true, if the given date is in Daylight Savings Time in this time zone.
void	setRawOffset(int offsetMillis) This does nothing - the raw offset is decoded from the file.
boolean	useDaylightTime() Returns if this TimeZone uses daylight savings.

Methods inherited from class java.util.TimeZone

clone, getAvailableIDs, getAvailableIDs, getDefault, getDisplayName, getDisplayName, getDisplayName, getID, getTimeZone, hasSameRules, setDefault, setID

Methods inherited from class java.lang.Object

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

Constructor Detail

TZifTimeZone

public TZifTimeZone(String fullName,
                    byte[] src,
                    int offset,
                    int length)
             throws IllegalArgumentException

Create a TZifTimeZone from the bytes of a TZif file.

Parameters:

src - the data bytes.

offset - the start of the data bytes.

length - the number of data bytes.

Throws:

IllegalArgumentException - if the data bytes are not a TZif formatted file.

Method Detail

getDisplayName

public String getDisplayName(boolean dst,
                             int style,
                             Locale locale)

Description copied from class: TimeZone

This method returns a string name of the time zone suitable for displaying to the user. The string returned will be of the specified type in the specified locale.

Overrides:

getDisplayName in class TimeZone

Parameters:

dst - Whether or not daylight savings time is in effect.

style - LONG for a long name, SHORT for a short abbreviation.

locale - The locale for this timezone name.

Returns:

The name of the time zone.

fromFile

public static TZifTimeZone fromFile(String fullName,
                                    File src)
                             throws IOException,
                                    IllegalArgumentException

A convenience method to create a TZifTimeZone from a File source.

Parameters:

fullName - the full name for the TZifTimeZone (e.g. "America/Port_Of_Spain") this may be null if it is not known.

src - the source file.

Returns:

a TZifTimeZone if the file is of the proper format.

Throws:

IOException - if there was an error reading from the file.

IllegalArgumentException - if the file was not of the proper format.

getOffset

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

Description copied from class: TimeZone

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.

Specified by:

getOffset in class 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

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

Returns:

the time zone offset in milliseconds.

getRawOffset

public int getRawOffset()

Description copied from class: TimeZone

Gets the time zone offset, ignoring daylight savings. This is the offset to add to UTC to get the local time.

Specified by:

getRawOffset in class TimeZone

Returns:

the time zone offset in milliseconds.

inDaylightTime

public boolean inDaylightTime(Date date)

Description copied from class: TimeZone

Returns true, if the given date is in Daylight Savings Time in this time zone.

Specified by:

inDaylightTime in class TimeZone

Parameters:

date - the given Date.

setRawOffset

public void setRawOffset(int offsetMillis)

This does nothing - the raw offset is decoded from the file.

Specified by:

setRawOffset in class TimeZone

Parameters:

offsetMillis - the time zone offset to GMT.

getDSTSavings

public int getDSTSavings()

Return the most up-to-date Daylight Savings Time change in milliseconds.

Overrides:

getDSTSavings in class TimeZone

Returns:

the daylight savings offset in milliseconds.

useDaylightTime

public boolean useDaylightTime()

Returns if this TimeZone uses daylight savings.

Specified by:

useDaylightTime in class TimeZone