Share this page 

Add/Substract Day/Month/Year to a DateTag(s): Date and Time


add() and roll() are used to add or substract values to a Calendar object.

You specify which Calendar field is to be affected by the operation (Calendar.YEAR, Calendar.MONTH, Calendar.DATE).

add() adds or substracts values to the specified Calendar field, the next larger field is modified when the result makes the Calendar "rolls over".

import java.util.Calendar;
import java.text.SimpleDateFormat;

public class Test {
  public static void main(String[] args) throws Exception {
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
    Calendar c1 = Calendar.getInstance();
    c1.set(1999, 0 , 20); // 1999 jan 20
    System.out.println("Date is : " + sdf.format(c1.getTime()));
    c1.add(Calendar.DATE,20);   // or  Calendar.DAY_OF_MONTH which is a synonym
    System.out.println("Date + 20 days is : " + sdf.format(c1.getTime()));
    /*
     * output :
     * Date is : 1999-01-20
     * Date + 20 days is : 1999-02-09
     */
 }
}
To substract, simply use a negative argument.

roll() does the same thing except you specify if you want to roll up (add 1) or roll down (substract 1) to the specified Calendar field. The operation only affects the specified field while add() adjusts other Calendar fields.

See the following example, roll() makes january rolls to december in the same year while add() substract the YEAR field for the correct result.

import java.util.Calendar;
import java.text.SimpleDateFormat;

public class Test {
  public static void main(String[] args) throws Exception {
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
    Calendar c1 = Calendar.getInstance();
    c1.set(1999, 0 , 20); // 1999 jan 20
    System.out.println("Date is : " + sdf.format(c1.getTime()));
    c1.roll(Calendar.MONTH, false); // roll down, substract 1 month
    System.out.println ("Date roll down 1 month : "
       + sdf.format(c1.getTime()));

    c1.set(1999, 0 , 20); // 1999 jan 20
    System.out.println("Date is : " + sdf.format(c1.getTime()));
    c1.add(Calendar.MONTH, -1); // substract 1 month
    System.out.println
      ("Date minus 1 month : "
          + sdf.format(c1.getTime()));
    /*
     * output :
     * Date is : 1999-01-20
     * Date roll down 1 month : 1999-12-20
     * Date is : 1999-01-20
     * Date minus 1 month : 1998-12-20
     */
 }
}