net.time4j.tz.model

Class GregorianTimezoneRule

java.lang.Object

net.time4j.tz.model.DaylightSavingRule

net.time4j.tz.model.GregorianTimezoneRule

All Implemented Interfaces:

Serializable

@CalendarType(value="iso8601")
public class GregorianTimezoneRule
extends DaylightSavingRule
implements Serializable

Represents a standard daylight saving rule following the gregorian calendar as used in IANA-TZDB.

Since:

2.2

Author:

Meno Hochschild

See Also:

Serialized Form

Concurrency:

This class is immutable and can be used by multiple threads in parallel.

Method Summary

Modifier and Type	Method and Description
PlainDate	getDate(int year) Determines the date of time switch dependent on given year.
Month	getMonth() Yields the gregorian month of time switch.
static GregorianTimezoneRule	ofFixedDay(Month month, int dayOfMonth, int timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for a fixed day in given month.
static GregorianTimezoneRule	ofFixedDay(Month month, int dayOfMonth, PlainTime timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for a fixed day in given month.
static GregorianTimezoneRule	ofLastWeekday(Month month, Weekday dayOfWeek, int timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for the last day of week in given month.
static GregorianTimezoneRule	ofLastWeekday(Month month, Weekday dayOfWeek, PlainTime timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for the last day of week in given month.
static GregorianTimezoneRule	ofWeekdayAfterDate(Month month, int dayOfMonth, Weekday dayOfWeek, int timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for a day of week after the given reference date.
static GregorianTimezoneRule	ofWeekdayAfterDate(Month month, int dayOfMonth, Weekday dayOfWeek, PlainTime timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for a day of week after the given reference date.
static GregorianTimezoneRule	ofWeekdayBeforeDate(Month month, int dayOfMonth, Weekday dayOfWeek, int timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for a day of week before the given reference date.
static GregorianTimezoneRule	ofWeekdayBeforeDate(Month month, int dayOfMonth, Weekday dayOfWeek, PlainTime timeOfDay, OffsetIndicator indicator, int savings) Creates a rule for a day of week before the given reference date.

Methods inherited from class net.time4j.tz.model.DaylightSavingRule

getIndicator, getSavings, getTimeOfDay

Methods inherited from class java.lang.Object

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

Method Detail

ofFixedDay

public static GregorianTimezoneRule ofFixedDay(Month month,
                                               int dayOfMonth,
                                               PlainTime timeOfDay,
                                               OffsetIndicator indicator,
                                               int savings)

Creates a rule for a fixed day in given month.

Parameters:

month - calendar month

dayOfMonth - day of month (1 - 31)

timeOfDay - clock time when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range or if the day of month is not valid in context of given month

Since:

2.2

ofFixedDay

public static GregorianTimezoneRule ofFixedDay(Month month,
                                               int dayOfMonth,
                                               int timeOfDay,
                                               OffsetIndicator indicator,
                                               int savings)

Creates a rule for a fixed day in given month.

Parameters:

month - calendar month

dayOfMonth - day of month (1 - 31)

timeOfDay - clock time in seconds after midnight when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range or if the day of month is not valid in context of given month

Since:

5.0

ofLastWeekday

public static GregorianTimezoneRule ofLastWeekday(Month month,
                                                  Weekday dayOfWeek,
                                                  PlainTime timeOfDay,
                                                  OffsetIndicator indicator,
                                                  int savings)

Creates a rule for the last day of week in given month.

Parameters:

month - calendar month

dayOfWeek - last day of week

timeOfDay - clock time in seconds after midnight when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range

Since:

2.2

ofLastWeekday

public static GregorianTimezoneRule ofLastWeekday(Month month,
                                                  Weekday dayOfWeek,
                                                  int timeOfDay,
                                                  OffsetIndicator indicator,
                                                  int savings)

Creates a rule for the last day of week in given month.

Parameters:

month - calendar month

dayOfWeek - last day of week

timeOfDay - clock time in seconds after midnight when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range

Since:

5.0

ofWeekdayAfterDate

public static GregorianTimezoneRule ofWeekdayAfterDate(Month month,
                                                       int dayOfMonth,
                                                       Weekday dayOfWeek,
                                                       PlainTime timeOfDay,
                                                       OffsetIndicator indicator,
                                                       int savings)

Creates a rule for a day of week after the given reference date.

Example => You have to set for the second Sunday in April: month=APRIL, dayOfMonth=8, dayOfWeek=SUNDAY.

Parameters:

month - calendar month

dayOfMonth - reference day of month (1 - 31)

dayOfWeek - day of week when time switch happens

timeOfDay - clock time when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range or if the day of month is not valid in context of given month

Since:

2.2

ofWeekdayAfterDate

public static GregorianTimezoneRule ofWeekdayAfterDate(Month month,
                                                       int dayOfMonth,
                                                       Weekday dayOfWeek,
                                                       int timeOfDay,
                                                       OffsetIndicator indicator,
                                                       int savings)

Creates a rule for a day of week after the given reference date.

Example => You have to set for the second Sunday in April: month=APRIL, dayOfMonth=8, dayOfWeek=SUNDAY.

Parameters:

month - calendar month

dayOfMonth - reference day of month (1 - 31)

dayOfWeek - day of week when time switch happens

timeOfDay - clock time in seconds after midnight when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range or if the day of month is not valid in context of given month

Since:

5.0

ofWeekdayBeforeDate

public static GregorianTimezoneRule ofWeekdayBeforeDate(Month month,
                                                        int dayOfMonth,
                                                        Weekday dayOfWeek,
                                                        PlainTime timeOfDay,
                                                        OffsetIndicator indicator,
                                                        int savings)

Creates a rule for a day of week before the given reference date.

Parameters:

month - calendar month

dayOfMonth - reference day of month (1 - 31)

dayOfWeek - day of week when time switch happens

timeOfDay - clock time when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range or if the day of month is not valid in context of given month

Since:

2.2

ofWeekdayBeforeDate

public static GregorianTimezoneRule ofWeekdayBeforeDate(Month month,
                                                        int dayOfMonth,
                                                        Weekday dayOfWeek,
                                                        int timeOfDay,
                                                        OffsetIndicator indicator,
                                                        int savings)

Creates a rule for a day of week before the given reference date.

Parameters:

month - calendar month

dayOfMonth - reference day of month (1 - 31)

dayOfWeek - day of week when time switch happens

timeOfDay - clock time in seconds after midnight when time switch happens

indicator - offset indicator

savings - fixed DST-offset in seconds

Returns:

new daylight saving rule

Throws:

IllegalArgumentException - if the last argument is out of range or if the day of month is not valid in context of given month

Since:

5.0

getDate

public final PlainDate getDate(int year)

Description copied from class: DaylightSavingRule

Determines the date of time switch dependent on given year.

The result must be interpreted by mean of DaylightSavingRule.getIndicator() in order to calculate the UTC date.

Specified by:

getDate in class DaylightSavingRule

Parameters:

year - reference year when a time switch happens

Returns:

calendar date of time switch

getMonth

public Month getMonth()

Yields the gregorian month of time switch.

Returns:

month

Since:

3.1