Added in API level 1

SimpleTimeZone

open class SimpleTimeZone : TimeZone

kotlin.Any
↳	java.util.TimeZone
	↳	java.util.SimpleTimeZone

SimpleTimeZone is a concrete subclass of TimeZone that represents a time zone for use with a Gregorian calendar. The class holds an offset from GMT, called raw offset, and start and end rules for a daylight saving time schedule. Since it only holds single values for each, it cannot handle historical changes in the offset from GMT and the daylight saving schedule, except that the setStartYear method can specify the year when the daylight saving time schedule starts in effect.

To construct a SimpleTimeZone with a daylight saving time schedule, the schedule can be described with a set of rules, start-rule and end-rule. A day when daylight saving time starts or ends is specified by a combination of month, day-of-month, and day-of-week values. The month value is represented by a Calendar MONTH field value, such as Calendar.MARCH. The day-of-week value is represented by a Calendar DAY_OF_WEEK value, such as SUNDAY. The meanings of value combinations are as follows.

• Exact day of month
  To specify an exact day of month, set the month and day-of-month to an exact value, and day-of-week to zero. For example, to specify March 1, set the month to MARCH, day-of-month to 1, and day-of-week to 0.
• Day of week on or after day of month
  To specify a day of week on or after an exact day of month, set the month to an exact month value, day-of-month to the day on or after which the rule is applied, and day-of-week to a negative DAY_OF_WEEK field value. For example, to specify the second Sunday of April, set month to APRIL, day-of-month to 8, and day-of-week to -SUNDAY.
• Day of week on or before day of month
  To specify a day of the week on or before an exact day of the month, set day-of-month and day-of-week to a negative value. For example, to specify the last Wednesday on or before the 21st of March, set month to MARCH, day-of-month is -21 and day-of-week is -WEDNESDAY.
• Last day-of-week of month
  To specify, the last day-of-week of the month, set day-of-week to a DAY_OF_WEEK value and day-of-month to -1. For example, to specify the last Sunday of October, set month to OCTOBER, day-of-week to SUNDAY and day-of-month to -1.

The time of the day at which daylight saving time starts or ends is specified by a millisecond value within the day. There are three kinds of modes to specify the time: WALL_TIME, STANDARD_TIME and UTC_TIME. For example, if daylight saving time ends at 2:00 am in the wall clock time, it can be specified by 7200000 milliseconds in the WALL_TIME mode. In this case, the wall clock time for an end-rule means the same thing as the daylight time.

The following are examples of parameters for constructing time zone objects.

<code>
       // Base GMT offset: -8:00
       // DST starts:      at 2:00am in standard time
       //                  on the first Sunday in April
       // DST ends:        at 2:00am in daylight time
       //                  on the last Sunday in October
       // Save:            1 hour
       SimpleTimeZone(-28800000,
                      "America/Los_Angeles",
                      Calendar.APRIL, 1, -Calendar.SUNDAY,
                      7200000,
                      Calendar.OCTOBER, -1, Calendar.SUNDAY,
                      7200000,
                      3600000)
 
       // Base GMT offset: +1:00
       // DST starts:      at 1:00am in UTC time
       //                  on the last Sunday in March
       // DST ends:        at 1:00am in UTC time
       //                  on the last Sunday in October
       // Save:            1 hour
       SimpleTimeZone(3600000,
                      "Europe/Paris",
                      Calendar.MARCH, -1, Calendar.SUNDAY,
                      3600000, SimpleTimeZone.UTC_TIME,
                      Calendar.OCTOBER, -1, Calendar.SUNDAY,
                      3600000, SimpleTimeZone.UTC_TIME,
                      3600000)
  </code>

These parameter rules are also applicable to the set rule methods, such as setStartRule.

Summary

Constants
static Int	STANDARD_TIME Constant for a mode of start or end time specified as standard time.
static Int	UTC_TIME Constant for a mode of start or end time specified as UTC.
static Int	WALL_TIME Constant for a mode of start or end time specified as wall clock time.

Inherited constants
From class TimeZone Int LONG A style specifier for getDisplayName() indicating a long name, such as "Pacific Standard Time." Int SHORT A style specifier for getDisplayName() indicating a short name, such as "PST."

Public constructors
SimpleTimeZone(rawOffset: Int, ID: String!) Constructs a SimpleTimeZone with the given base time zone offset from GMT and time zone ID with no daylight saving time schedule.
SimpleTimeZone(rawOffset: Int, ID: String!, startMonth: Int, startDay: Int, startDayOfWeek: Int, startTime: Int, endMonth: Int, endDay: Int, endDayOfWeek: Int, endTime: Int) Constructs a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, and rules for starting and ending the daylight time.
SimpleTimeZone(rawOffset: Int, ID: String!, startMonth: Int, startDay: Int, startDayOfWeek: Int, startTime: Int, endMonth: Int, endDay: Int, endDayOfWeek: Int, endTime: Int, dstSavings: Int) Constructs a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, and rules for starting and ending the daylight time.
SimpleTimeZone(rawOffset: Int, ID: String!, startMonth: Int, startDay: Int, startDayOfWeek: Int, startTime: Int, startTimeMode: Int, endMonth: Int, endDay: Int, endDayOfWeek: Int, endTime: Int, endTimeMode: Int, dstSavings: Int) Constructs a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, and rules for starting and ending the daylight time.

Public methods
open Any	clone() Returns a clone of this SimpleTimeZone instance.
open Boolean	equals(other: Any?) Compares the equality of two SimpleTimeZone objects.
open Int	getDSTSavings() Returns the amount of time in milliseconds that the clock is advanced during daylight saving time.
open Int	getOffset(era: Int, year: Int, month: Int, day: Int, dayOfWeek: Int, millis: Int) Returns the difference in milliseconds between local time and UTC, taking into account both the raw offset and the effect of daylight saving, for the specified date and time.
open Int	getOffset(date: Long) Returns the offset of this time zone from UTC at the given time.
open Int	getRawOffset() Gets the GMT offset for this time zone.
open Boolean	hasSameRules(other: TimeZone!) Returns true if this zone has the same rules and offset as another zone.
open Int	hashCode() Generates the hash code for the SimpleDateFormat object.
open Boolean	inDaylightTime(date: Date!) Queries if the given date is in daylight saving time.
open Boolean	observesDaylightTime() Returns true if this SimpleTimeZone observes Daylight Saving Time.
open Unit	setDSTSavings(millisSavedDuringDST: Int) Sets the amount of time in milliseconds that the clock is advanced during daylight saving time.
open Unit	setEndRule(endMonth: Int, endDay: Int, endTime: Int) Sets the daylight saving time end rule to a fixed date within a month.
open Unit	setEndRule(endMonth: Int, endDay: Int, endDayOfWeek: Int, endTime: Int) Sets the daylight saving time end rule.
open Unit	setEndRule(endMonth: Int, endDay: Int, endDayOfWeek: Int, endTime: Int, after: Boolean) Sets the daylight saving time end rule to a weekday before or after the given date within a month, e.
open Unit	setRawOffset(offsetMillis: Int) Sets the base time zone offset to GMT.
open Unit	setStartRule(startMonth: Int, startDay: Int, startTime: Int) Sets the daylight saving time start rule to a fixed date within a month.
open Unit	setStartRule(startMonth: Int, startDay: Int, startDayOfWeek: Int, startTime: Int) Sets the daylight saving time start rule.
open Unit	setStartRule(startMonth: Int, startDay: Int, startDayOfWeek: Int, startTime: Int, after: Boolean) Sets the daylight saving time start rule to a weekday before or after the given date within a month, e.
open Unit	setStartYear(year: Int) Sets the daylight saving time starting year.
open String	toString() Returns a string representation of this time zone.
open Boolean	useDaylightTime() Queries if this time zone uses daylight saving time.

Inherited functions

From class TimeZone Array<String!>! getAvailableIDs() Gets all the available IDs supported. Array<String!>! getAvailableIDs(rawOffset: Int) Gets the available IDs according to the given time zone offset in milliseconds. TimeZone! getDefault() Gets the default TimeZone for this host. The source of the default TimeZone may vary with implementation. String! getDisplayName() Returns a long standard time name of this TimeZone suitable for presentation to the user in the default locale. This method is equivalent to: {@snippet lang=java : * // @link substring="LONG" target="#LONG" : * getDisplayName(false, LONG, * // @link substring="Locale.Category.DISPLAY" target="Locale.Category#DISPLAY" : * Locale.getDefault(Locale.Category.DISPLAY)); * } String! getDisplayName(daylight: Boolean, style: Int) Returns a name in the specified style of this TimeZone suitable for presentation to the user in the default locale. If the specified daylight is true, a Daylight Saving Time name is returned (even if this TimeZone doesn't observe Daylight Saving Time). Otherwise, a Standard Time name is returned. This method is equivalent to: {@snippet lang=java : * getDisplayName(daylight, style, * // @link substring="Locale.Category.DISPLAY" target="Locale.Category#DISPLAY" : * Locale.getDefault(Locale.Category.DISPLAY)); * } String! getDisplayName(daylightTime: Boolean, style: Int, locale: Locale!) Returns the short or long name of this time zone with either standard or daylight time, as written in locale. If the name is not available, the result is in the format GMT[+-]hh:mm. String! getDisplayName(locale: Locale!) Returns a long standard time name of this TimeZone suitable for presentation to the user in the specified locale. This method is equivalent to: {@snippet lang=java : * // @link substring="LONG" target="#LONG" : * getDisplayName(false, LONG, locale); * } String! getID() Gets the ID of this time zone. TimeZone! getTimeZone(id: String!) Gets the TimeZone for the given ID. TimeZone! getTimeZone(zoneId: ZoneId!) Gets the TimeZone for the given zoneId. Unit setDefault(timeZone: TimeZone!) Sets the TimeZone that is returned by the getDefault method. zone is cached. If zone is null, the cached default TimeZone is cleared. This method doesn't change the value of the user.timezone property. Unit setID(ID: String!) Sets the time zone ID. This does not change any other data in the time zone object. ZoneId! toZoneId() Converts this TimeZone object to a ZoneId.

Constants

STANDARD_TIME

Added in API level 1

static val STANDARD_TIME: Int

Constant for a mode of start or end time specified as standard time.

Value: 1

UTC_TIME

Added in API level 1

static val UTC_TIME: Int

Constant for a mode of start or end time specified as UTC. European Union rules are specified as UTC time, for example.

Value: 2

WALL_TIME

Added in API level 1

static val WALL_TIME: Int

Constant for a mode of start or end time specified as wall clock time. Wall clock time is standard time for the onset rule, and daylight time for the end rule.

Value: 0

Public constructors

SimpleTimeZone

Added in API level 1

SimpleTimeZone(
    rawOffset: Int, 
    ID: String!)

Constructs a SimpleTimeZone with the given base time zone offset from GMT and time zone ID with no daylight saving time schedule.

Parameters
rawOffset	Int: The base time zone offset in milliseconds to GMT.
ID	String!: The time zone name that is given to this instance.

SimpleTimeZone

Added in API level 1

SimpleTimeZone(
    rawOffset: Int, 
    ID: String!, 
    startMonth: Int, 
    startDay: Int, 
    startDayOfWeek: Int, 
    startTime: Int, 
    endMonth: Int, 
    endDay: Int, 
    endDayOfWeek: Int, 
    endTime: Int)

Constructs a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, and rules for starting and ending the daylight time. Both startTime and endTime are specified to be represented in the wall clock time. The amount of daylight saving is assumed to be 3600000 milliseconds (i.e., one hour). This constructor is equivalent to:

<code>
      SimpleTimeZone(rawOffset,
                     ID,
                     startMonth,
                     startDay,
                     startDayOfWeek,
                     startTime,
                     SimpleTimeZone.<code><a docref="java.util.SimpleTimeZone$WALL_TIME">#WALL_TIME</a></code>,
                     endMonth,
                     endDay,
                     endDayOfWeek,
                     endTime,
                     SimpleTimeZone.<code><a docref="java.util.SimpleTimeZone$WALL_TIME">#WALL_TIME</a></code>,
                     3600000)
  </code>

Parameters
rawOffset	Int: The given base time zone offset from GMT.
ID	String!: The time zone ID which is given to this object.
startMonth	Int: The daylight saving time starting month. Month is a MONTH field value (0-based. e.g., 0 for January).
startDay	Int: The day of the month on which the daylight saving time starts. See the class description for the special cases of this parameter.
startDayOfWeek	Int: The daylight saving time starting day-of-week. See the class description for the special cases of this parameter.
startTime	Int: The daylight saving time starting time in local wall clock time (in milliseconds within the day), which is local standard time in this case.
endMonth	Int: The daylight saving time ending month. Month is a MONTH field value (0-based. e.g., 9 for October).
endDay	Int: The day of the month on which the daylight saving time ends. See the class description for the special cases of this parameter.
endDayOfWeek	Int: The daylight saving time ending day-of-week. See the class description for the special cases of this parameter.
endTime	Int: The daylight saving ending time in local wall clock time, (in milliseconds within the day) which is local daylight time in this case.

Exceptions
java.lang.IllegalArgumentException	if the month, day, dayOfWeek, or time parameters are out of range for the start or end rule

SimpleTimeZone

Added in API level 1

SimpleTimeZone(
    rawOffset: Int, 
    ID: String!, 
    startMonth: Int, 
    startDay: Int, 
    startDayOfWeek: Int, 
    startTime: Int, 
    endMonth: Int, 
    endDay: Int, 
    endDayOfWeek: Int, 
    endTime: Int, 
    dstSavings: Int)

Constructs a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, and rules for starting and ending the daylight time. Both startTime and endTime are assumed to be represented in the wall clock time. This constructor is equivalent to:

<code>
      SimpleTimeZone(rawOffset,
                     ID,
                     startMonth,
                     startDay,
                     startDayOfWeek,
                     startTime,
                     SimpleTimeZone.<code><a docref="java.util.SimpleTimeZone$WALL_TIME">#WALL_TIME</a></code>,
                     endMonth,
                     endDay,
                     endDayOfWeek,
                     endTime,
                     SimpleTimeZone.<code><a docref="java.util.SimpleTimeZone$WALL_TIME">#WALL_TIME</a></code>,
                     dstSavings)
  </code>

Parameters
rawOffset	Int: The given base time zone offset from GMT.
ID	String!: The time zone ID which is given to this object.
startMonth	Int: The daylight saving time starting month. Month is a MONTH field value (0-based. e.g., 0 for January).
startDay	Int: The day of the month on which the daylight saving time starts. See the class description for the special cases of this parameter.
startDayOfWeek	Int: The daylight saving time starting day-of-week. See the class description for the special cases of this parameter.
startTime	Int: The daylight saving time starting time in local wall clock time, which is local standard time in this case.
endMonth	Int: The daylight saving time ending month. Month is a MONTH field value (0-based. e.g., 9 for October).
endDay	Int: The day of the month on which the daylight saving time ends. See the class description for the special cases of this parameter.
endDayOfWeek	Int: The daylight saving time ending day-of-week. See the class description for the special cases of this parameter.
endTime	Int: The daylight saving ending time in local wall clock time, which is local daylight time in this case.
dstSavings	Int: The amount of time in milliseconds saved during daylight saving time.

Exceptions
java.lang.IllegalArgumentException	if the month, day, dayOfWeek, or time parameters are out of range for the start or end rule

SimpleTimeZone

Added in API level 1

SimpleTimeZone(
    rawOffset: Int, 
    ID: String!, 
    startMonth: Int, 
    startDay: Int, 
    startDayOfWeek: Int, 
    startTime: Int, 
    startTimeMode: Int, 
    endMonth: Int, 
    endDay: Int, 
    endDayOfWeek: Int, 
    endTime: Int, 
    endTimeMode: Int, 
    dstSavings: Int)

Constructs a SimpleTimeZone with the given base time zone offset from GMT, time zone ID, and rules for starting and ending the daylight time. This constructor takes the full set of the start and end rules parameters, including modes of startTime and endTime. The mode specifies either wall or standard time or UTC.

Parameters
rawOffset	Int: The given base time zone offset from GMT.
ID	String!: The time zone ID which is given to this object.
startMonth	Int: The daylight saving time starting month. Month is a MONTH field value (0-based. e.g., 0 for January).
startDay	Int: The day of the month on which the daylight saving time starts. See the class description for the special cases of this parameter.
startDayOfWeek	Int: The daylight saving time starting day-of-week. See the class description for the special cases of this parameter.
startTime	Int: The daylight saving time starting time in the time mode specified by startTimeMode.
startTimeMode	Int: The mode of the start time specified by startTime.
endMonth	Int: The daylight saving time ending month. Month is a MONTH field value (0-based. e.g., 9 for October).
endDay	Int: The day of the month on which the daylight saving time ends. See the class description for the special cases of this parameter.
endDayOfWeek	Int: The daylight saving time ending day-of-week. See the class description for the special cases of this parameter.
endTime	Int: The daylight saving ending time in time mode specified by endTimeMode.
endTimeMode	Int: The mode of the end time specified by endTime
dstSavings	Int: The amount of time in milliseconds saved during daylight saving time.

Exceptions
java.lang.IllegalArgumentException	if the month, day, dayOfWeek, time more, or time parameters are out of range for the start or end rule, or if a time mode value is invalid.

See Also

• #WALL_TIME
• #STANDARD_TIME
• #UTC_TIME

Public methods

clone

Added in API level 1

open fun clone(): Any

Returns a clone of this SimpleTimeZone instance.

Return
Any	a clone of this instance.

Exceptions
java.lang.CloneNotSupportedException	if the object's class does not support the Cloneable interface. Subclasses that override the clone method can also throw this exception to indicate that an instance cannot be cloned.

equals

Added in API level 1

open fun equals(other: Any?): Boolean

Compares the equality of two SimpleTimeZone objects.

Parameters
obj	The SimpleTimeZone object to be compared with.

Return
Boolean	True if the given obj is the same as this SimpleTimeZone object; false otherwise.

getDSTSavings

Added in API level 1

open fun getDSTSavings(): Int

Returns the amount of time in milliseconds that the clock is advanced during daylight saving time.

Return
Int	the number of milliseconds the time is advanced with respect to standard time when the daylight saving rules are in effect, or 0 (zero) if this time zone doesn't observe daylight saving time.

See Also

• #setDSTSavings

getOffset

Added in API level 1

open fun getOffset(
    era: Int, 
    year: Int, 
    month: Int, 
    day: Int, 
    dayOfWeek: Int, 
    millis: Int
): Int

Returns the difference in milliseconds between local time and UTC, taking into account both the raw offset and the effect of daylight saving, for the specified date and time. This method assumes that the start and end month are distinct. It also uses a default GregorianCalendar object as its underlying calendar, such as for determining leap years. Do not use the result of this method with a calendar other than a default GregorianCalendar.

Note: In general, clients should use Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET) instead of calling this method.

Parameters
era	Int: The era of the given date.
year	Int: The year in the given date.
month	Int: The month in the given date. Month is 0-based. e.g., 0 for January.
day	Int: The day-in-month of the given date.
dayOfWeek	Int: The day-of-week of the given date.
milliseconds	the milliseconds in day in standard local time.
millis	Int: The milliseconds in day in standard local time.

Return
Int	The milliseconds to add to UTC to get local time.

Exceptions
java.lang.IllegalArgumentException	the era, month, day, dayOfWeek, or millis parameters are out of range

getOffset

Added in API level 1

open fun getOffset(date: Long): Int

Returns the offset of this time zone from UTC at the given time. If daylight saving time is in effect at the given time, the offset value is adjusted with the amount of daylight saving.

Parameters
date	Long: the time at which the time zone offset is found

Return
Int	the amount of time in milliseconds to add to UTC to get local time.

getRawOffset

Added in API level 1

open fun getRawOffset(): Int

Gets the GMT offset for this time zone.

Return
Int	the GMT offset value in milliseconds

See Also

• #setRawOffset

hasSameRules

Added in API level 1

open fun hasSameRules(other: TimeZone!): Boolean

Returns true if this zone has the same rules and offset as another zone.

Parameters
other	TimeZone!: the TimeZone object to be compared with

Return
Boolean	true if the given zone is a SimpleTimeZone and has the same rules and offset as this one

hashCode

Added in API level 1

open fun hashCode(): Int

Generates the hash code for the SimpleDateFormat object.

Return
Int	the hash code for this object

inDaylightTime

Added in API level 1

open fun inDaylightTime(date: Date!): Boolean

Queries if the given date is in daylight saving time.

Parameters
date	Date!: the given Date.

Return
Boolean	true if daylight saving time is in effective at the given date; false otherwise.

Exceptions
java.lang.NullPointerException	This method may throw a NullPointerException if date is null

observesDaylightTime

Added in API level 24

open fun observesDaylightTime(): Boolean

Returns true if this SimpleTimeZone observes Daylight Saving Time. This method is equivalent to useDaylightTime().

Return
Boolean	true if this SimpleTimeZone observes Daylight Saving Time; false otherwise.

setDSTSavings

Added in API level 1

open fun setDSTSavings(millisSavedDuringDST: Int): Unit

Sets the amount of time in milliseconds that the clock is advanced during daylight saving time.

Parameters
millisSavedDuringDST	Int: the number of milliseconds the time is advanced with respect to standard time when the daylight saving time rules are in effect. A positive number, typically one hour (3600000).

See Also

• #getDSTSavings

setEndRule

Added in API level 1

open fun setEndRule(
    endMonth: Int, 
    endDay: Int, 
    endTime: Int
): Unit

Sets the daylight saving time end rule to a fixed date within a month. This method is equivalent to:

<code>setEndRule(endMonth, endDay, 0, endTime)</code>

Parameters
endMonth	Int: The daylight saving time ending month. Month is a MONTH field value (0-based. e.g., 9 for October).
endDay	Int: The day of the month on which the daylight saving time ends.
endTime	Int: The daylight saving ending time in local wall clock time, (in milliseconds within the day) which is local daylight time in this case.

Exceptions
java.lang.IllegalArgumentException	the endMonth, endDay, or endTime parameters are out of range

setEndRule

Added in API level 1

open fun setEndRule(
    endMonth: Int, 
    endDay: Int, 
    endDayOfWeek: Int, 
    endTime: Int
): Unit

Sets the daylight saving time end rule. For example, if daylight saving time ends on the last Sunday in October at 2 am in wall clock time, you can set the end rule by calling: setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);

Parameters
endMonth	Int: The daylight saving time ending month. Month is a MONTH field value (0-based. e.g., 9 for October).
endDay	Int: The day of the month on which the daylight saving time ends. See the class description for the special cases of this parameter.
endDayOfWeek	Int: The daylight saving time ending day-of-week. See the class description for the special cases of this parameter.
endTime	Int: The daylight saving ending time in local wall clock time, (in milliseconds within the day) which is local daylight time in this case.

Exceptions
java.lang.IllegalArgumentException	if the endMonth, endDay, endDayOfWeek, or endTime parameters are out of range

setEndRule

Added in API level 1

open fun setEndRule(
    endMonth: Int, 
    endDay: Int, 
    endDayOfWeek: Int, 
    endTime: Int, 
    after: Boolean
): Unit

Sets the daylight saving time end rule to a weekday before or after the given date within a month, e.g., the first Monday on or after the 8th.

Parameters
endMonth	Int: The daylight saving time ending month. Month is a MONTH field value (0-based. e.g., 9 for October).
endDay	Int: The day of the month on which the daylight saving time ends.
endDayOfWeek	Int: The daylight saving time ending day-of-week.
endTime	Int: The daylight saving ending time in local wall clock time, (in milliseconds within the day) which is local daylight time in this case.
after	Boolean: If true, this rule selects the first endDayOfWeek on or after endDay. If false, this rule selects the last endDayOfWeek on or before endDay of the month.

Exceptions
java.lang.IllegalArgumentException	the endMonth, endDay, endDayOfWeek, or endTime parameters are out of range

setRawOffset

Added in API level 1

open fun setRawOffset(offsetMillis: Int): Unit

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

Parameters
offsetMillis	Int: the given base time zone offset to GMT.

See Also

• #getRawOffset

setStartRule

Added in API level 1

open fun setStartRule(
    startMonth: Int, 
    startDay: Int, 
    startTime: Int
): Unit

Sets the daylight saving time start rule to a fixed date within a month. This method is equivalent to:

<code>setStartRule(startMonth, startDay, 0, startTime)</code>

Parameters
startMonth	Int: The daylight saving time starting month. Month is a MONTH field value (0-based. e.g., 0 for January).
startDay	Int: The day of the month on which the daylight saving time starts.
startTime	Int: The daylight saving time starting time in local wall clock time, which is local standard time in this case. See the class description for the special cases of this parameter.

Exceptions
java.lang.IllegalArgumentException	if the startMonth, startDayOfMonth, or startTime parameters are out of range

setStartRule

Added in API level 1

open fun setStartRule(
    startMonth: Int, 
    startDay: Int, 
    startDayOfWeek: Int, 
    startTime: Int
): Unit

Sets the daylight saving time start rule. For example, if daylight saving time starts on the first Sunday in April at 2 am in local wall clock time, you can set the start rule by calling:

<code>setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);</code>

Parameters
startMonth	Int: The daylight saving time starting month. Month is a MONTH field value (0-based. e.g., 0 for January).
startDay	Int: The day of the month on which the daylight saving time starts. See the class description for the special cases of this parameter.
startDayOfWeek	Int: The daylight saving time starting day-of-week. See the class description for the special cases of this parameter.
startTime	Int: The daylight saving time starting time in local wall clock time, which is local standard time in this case.

Exceptions
java.lang.IllegalArgumentException	if the startMonth, startDay, startDayOfWeek, or startTime parameters are out of range

setStartRule

Added in API level 1

open fun setStartRule(
    startMonth: Int, 
    startDay: Int, 
    startDayOfWeek: Int, 
    startTime: Int, 
    after: Boolean
): Unit

Sets the daylight saving time start rule to a weekday before or after the given date within a month, e.g., the first Monday on or after the 8th.

Parameters
startMonth	Int: The daylight saving time starting month. Month is a MONTH field value (0-based. e.g., 0 for January).
startDay	Int: The day of the month on which the daylight saving time starts.
startDayOfWeek	Int: The daylight saving time starting day-of-week.
startTime	Int: The daylight saving time starting time in local wall clock time, which is local standard time in this case.
after	Boolean: If true, this rule selects the first dayOfWeek on or after dayOfMonth. If false, this rule selects the last dayOfWeek on or before dayOfMonth.

Exceptions
java.lang.IllegalArgumentException	if the startMonth, startDay, startDayOfWeek, or startTime parameters are out of range

setStartYear

Added in API level 1

open fun setStartYear(year: Int): Unit

Sets the daylight saving time starting year.

Parameters
year	Int: The daylight saving starting year.

toString

Added in API level 1

open fun toString(): String

Returns a string representation of this time zone.

Return
String	a string representation of this time zone.

useDaylightTime

Added in API level 1

open fun useDaylightTime(): Boolean

Queries if this time zone uses daylight saving time.

Return
Boolean	true if this time zone uses daylight saving time; false otherwise.