Java GregorianCalendar add() Method

---

---

Description

The Java GregorianCalendar add(int field,int amount) method adds the specified (signed) amount of time to the given calendar field, based on the calendar's rules.

Declaration

Following is the declaration for java.util.GregorianCalendar.add() method

public void add(int field,int amount)

Parameters

• field − the calendar field.

• amount − the amount of date or time to be added to the field.

Return Value

This method does not return a value

Exception

IllegalArgumentException − if field is ZONE_OFFSET, DST_OFFSET, or unknown, or if any calendar fields have out-of-range values in non-lenient mode.

Adding Two Months to the Current Dated GregorianCalendar Instance Example

The following example shows the usage of Java GregorianCalendar add() method. We're creating a GregorianCalendar instance of current date and adding 2 months to it using add method and then printing the updated date.

package com.tutorialspoint;

import java.util.GregorianCalendar;

public class GregorianCalendarDemo {
   public static void main(String[] args) {

      // create a new calendar
      GregorianCalendar cal = (GregorianCalendar) GregorianCalendar.getInstance();

      // print the current date and time
      System.out.println("" + cal.getTime());

      // add 2 months 
      cal.add((GregorianCalendar.MONTH), 2);

      // print the modified date and time
      System.out.println("" + cal.getTime());
   }
}

Output

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

Fri Nov 18 10:14:39 IST 2022
Wed Jan 18 10:14:39 IST 2023

Adding Two Years to the Current Dated GregorianCalendar Instance Example

The following example shows the usage of Java GregorianCalendar add() method. We're creating a GregorianCalendar instance of current date and adding 2 years to it using add method and then printing the updated date.

package com.tutorialspoint;

import java.util.GregorianCalendar;

public class GregorianCalendarDemo {
   public static void main(String[] args) {

      // create a new calendar
      GregorianCalendar cal = (GregorianCalendar) GregorianCalendar.getInstance();

      // print the current date and time
      System.out.println("" + cal.getTime());

      // add 2 years 
      cal.add((GregorianCalendar.YEAR), 2);

      // print the modified date and time
      System.out.println("" + cal.getTime());
   }
}

Output

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

Fri Nov 18 10:15:16 IST 2022
Mon Nov 18 10:15:16 IST 2024

Adding Two Days to the Current Dated GregorianCalendar Instance Example

The following example shows the usage of Java GregorianCalendar add() method. We're creating a GregorianCalendar instance of current date and adding 2 days to it using add method and then printing the updated date.

package com.tutorialspoint;

import java.util.GregorianCalendar;

public class GregorianCalendarDemo {
   public static void main(String[] args) {

      // create a new calendar
      GregorianCalendar cal = (GregorianCalendar) GregorianCalendar.getInstance();

      // print the current date and time
      System.out.println("" + cal.getTime());

      // add 2 days 
      cal.add((GregorianCalendar.DATE), 2);

      // print the modified date and time
      System.out.println("" + cal.getTime());
   }
}

Output

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

Fri Nov 18 10:16:00 IST 2022
Sun Nov 20 10:16:00 IST 2022