Android Date Add addYearToDate(Date date, int yearsToBeAdded)

Description

Add / Subtract given no of years to Date .

Parameter

Parameter	Description
date	- Date object.
yearsToBeAdded	-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 addYearToDate(Date date, int yearsToBeAdded) 

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{
    /***//w  w  w  . j  ava2  s  . c  o  m
     *  Add / Subtract given no of years to {@link Date}.
     *  
     * @param date -{@link Date} object.
     * @param yearsToBeAdded -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 addYearToDate(Date date, int yearsToBeAdded) {
        if (StringUtils.isNull(date)) {
            throw new NullPointerException("date cannot be null");
        }
        return add(date, Calendar.YEAR, yearsToBeAdded);
    }
    /**
     * 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. addMonthsToDate(Date date, int monthsToBeAdded)
2. addSeconds(Date date, int amount)
3. addSeconds(Date date, int amount)
4. addWeeks(Date date, int amount)
5. addWeeks(Date date, int amount)
6. addYears(Date date, int amount)
7. addYears(Date date, int amount)
8. dateByAddHoursAndMinutes(Date date, int hours, int minutes)
9. getDateAdd(Date date, int amount)