Java.util.GregorianCalendar.add() Method


Advertisements


Description

The java.util.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.

Example

The following example shows the usage of java.util.GregorianCalendar.add() method.

package com.tutorialspoint;

import java.util.*;

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());

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

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

   }
}

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

Fri May 18 02:25:26 EEST 2012
Wed Jul 18 02:25:26 EEST 2012
Fri Jul 18 02:25:26 EEST 2014

java_util_gregoriancalendar.htm

Advertisements