Android Date Add addMinuteToDate(Date date, int minutesToBeAdded)

Description

Add / Subtract given no of minutes to Date .

Parameter

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

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{
    /**// ww w .  j  av a 2s  .  c  om
     * Add / Subtract given no of minutes to {@link Date}.
     * 
     * @param date -{@link Date} object.
     * @param minutesToBeAdded -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 addMinuteToDate(Date date, int minutesToBeAdded) {
        if (StringUtils.isNull(date)) {
            throw new NullPointerException("date cannot be null");
        }
        return add(date, Calendar.MINUTE, minutesToBeAdded);
    }
    /**
     * 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. addHours(Date date, int amount)
2. addHours(Date date, int amount)
3. addHoursToDate(Date date, int hoursToBeAdded)
4. addMilliseconds(Date date, int amount)
5. addMilliseconds(Date date, int amount)
6. addMinutes(Date date, int amount)
7. addMinutes(Date date, int amount)
8. addMonths(Date date, int amount)
9. addMonths(Date date, int amount)