java.util.SimpleTimeZone.setStartRule() Method

Description

The setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime, boolean after) method is used to set the daylight saving time start rule to a weekday before or after the given date within a month.

Declaration

Following is the declaration for java.util.SimpleTimeZone.setStartRule() method.

public void setStartRule(int startMonth,
                         int startDay,
                         int startDayOfWeek,
                         int startTime,
                         boolean after)

Parameters

• startMonth--The daylight saving time starting month.

• startDay--The day of the month on which the daylight saving time starts.

• startDayOfWeek--The daylight saving time starting day-of-week.

• startTime--The daylight saving time starting time in local wall clock time.

• after--If true, this rule selects the first dayOfWeek on or after dayOfMonth. If false, this rule selects the last dayOfWeek on or before dayOfMonth.

Return Value

NA

Exception

• IllegalArgumentException--This is thrown if the startMonth, startDay, startDayOfWeek, or startTime parameters are out of range.

Example

The following example shows the usage of java.util.SimpleTimeZone.setStartRule()

package com.tutorialspoint;

import java.util.*;

public class SimpleTimeZoneDemo {
   public static void main( String args[] ){
      // create simple time zone object
      SimpleTimeZone stobj = new SimpleTimeZone(820,"US");
       
      // checking initial value     
      System.out.println("Initial value: " + stobj);
      
      // setting start rule   
      stobj.setStartRule( Calendar.MAY, 2,2, 3600000,true);   
      
      // checking the new value      
      System.out.println("Final value : " + stobj);
   }     
}

Let us compile and run the above program, this will produce the following result.

Initial value: java.util.SimpleTimeZone[id=US,offset=820,dstSavings=3600000,
useDaylight=false,startYear=0,startMode=0,startMonth=0,startDay=0,
startDayOfWeek=0,startTime=0,startTimeMode=0,endMode=0,endMonth=0,
endDay=0,endDayOfWeek=0,endTime=0,endTimeMode=0]

Final value : java.util.SimpleTimeZone[id=US,offset=820,dstSavings=3600000,
useDaylight=false,startYear=0,startMode=3,startMonth=4,startDay=2,
startDayOfWeek=2,startTime=3600000,startTimeMode=0,endMode=0,
endMonth=0,endDay=0,endDayOfWeek=0,endTime=0,endTimeMode=0]dMonth=0,
endDay=0,endDayOfWeek=0,
endTime=0,endTimeMode=0]