Java Doc for SimpleTimeZone.java in  » 6.0-JDK-Modules » j2me » java » util » Java Source Code / Java DocumentationJava Source Code and Java Documentation

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 Calendar.MONTH MONTH field value, such as Calendar.MARCH . The day-of-week value is represented by a Calendar Calendar.DAY_OF_WEEK DAY_OF_WEEK value, such as Calendar.SUNDAY 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 Calendar.MARCHMARCH , 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 Calendar.DAY_OF_WEEK DAY_OF_WEEK field value. For example, to specify the second Sunday of April, set month to Calendar.APRIL APRIL , day-of-month to 8, and day-of-week to Calendar.SUNDAY 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 Calendar.MARCH MARCH , day-of-month is -21 and day-of-week is Calendar.WEDNESDAY -WEDNESDAY .
• Last day-of-week of month
  To specify, the last day-of-week of the month, set day-of-week to a Calendar.DAY_OF_WEEK DAY_OF_WEEK value and day-of-month to -1. For example, to specify the last Sunday of October, set month to Calendar.OCTOBER OCTOBER , day-of-week to Calendar.SUNDAY SUNDAY and day-of-month to -1.

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

 // 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)
 

setEndRule(endMonth, endDay, 0, endTime)

setStartRule(startMonth, startDay, 0, startTime)

 SimpleTimeZone(rawOffset,
 ID,
 startMonth,
 startDay,
 startDayOfWeek,
 startTime,
 SimpleTimeZone.
SimpleTimeZone.WALL_TIME ,
 endMonth,
 endDay,
 endDayOfWeek,
 endTime,
 SimpleTimeZone.
SimpleTimeZone.WALL_TIME ,
 3600000)
 

 SimpleTimeZone(rawOffset,
 ID,
 startMonth,
 startDay,
 startDayOfWeek,
 startTime,
 SimpleTimeZone.
SimpleTimeZone.WALL_TIME ,
 endMonth,
 endDay,
 endDayOfWeek,
 endTime,
 SimpleTimeZone.
SimpleTimeZone.WALL_TIME ,
 dstSavings)
 

Note: In general, clients should use Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET) instead of calling this method.
Parameters:
  era - The era of the given date.
Parameters:
  year - The year in the given date.
Parameters:
  month - The month in the given date. Month is 0-based. e.g.,0 for January.
Parameters:
  day - The day-in-month of the given date.
Parameters:
  dayOfWeek - The day-of-week of the given date.
Parameters:
  millis - The milliseconds in day in standard local time. The milliseconds to add to UTC to get local time.
exception:
  IllegalArgumentException - the era,month, day, dayOfWeek,or millis parameters are out of range

setEndRule(endMonth, endDay, 0, endTime)

setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);

setStartRule(startMonth, startDay, 0, startTime)