Android Date Add addMonthsToDate(Date date, int monthsToBeAdded)

Description

Add / Subtract given no of months to Date .

Parameter

Parameter	Description
date	- Date object.
monthsToBeAdded	-amount by which to be changed.

Exception

Parameter	Description
NullPointerException	if any of the parameters is null.

Return

-new object with updated time.

Declaration

public static Date addMonthsToDate(Date date, int monthsToBeAdded) 

Method Source Code

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import java.util.Locale;

public class Main{
    /***//from w  w w .j  a v a2 s. c  o  m
     *  Add / Subtract given no of months to {@link Date}.
     *  
     * @param date -{@link Date} object.
     * @param monthsToBeAdded -amount by which to be changed.
     * @return -new {@link Date} object with updated time.
     * @throws NullPointerException if any of the parameters is null. 
     */
    public static Date addMonthsToDate(Date date, int monthsToBeAdded) {
        if (StringUtils.isNull(date)) {
            throw new NullPointerException("date cannot be null");
        }
        return add(date, Calendar.MONTH, monthsToBeAdded);
    }
    /**
     * Used internally to add/subtract amount to specific calendar field.
     * 
     * @param date -{@link Date} object.
     * @param calendarField -calendar specific field.
     * @param amount -int, value by which field should be changed.
     * @return -new {@link Date} object with updated time.
     * @throws NullPointerException if any of the parameters is null.
     */
    private static Date add(Date date, int calendarField, int amount) {
        if (StringUtils.isNull(date)) {
            throw new NullPointerException("date cannot be null");
        }
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        c.add(calendarField, amount);
        return c.getTime();
    }
}

Related

1. addMinuteToDate(Date date, int minutesToBeAdded)
2. addMinutes(Date date, int amount)
3. addMinutes(Date date, int amount)
4. addMonths(Date date, int amount)
5. addMonths(Date date, int amount)
6. addSeconds(Date date, int amount)
7. addSeconds(Date date, int amount)
8. addWeeks(Date date, int amount)
9. addWeeks(Date date, int amount)