Android Date Set set(Date date, int calendarField, int amount)

Description

Sets the specified field to a date returning a new object.

License

Apache License

Parameter

Parameter	Description
date	the date, not null
calendarField	the Calendar field to set the amount to
amount	the amount to set

Exception

Parameter	Description
IllegalArgumentException	if the date is null

Return

a new Date set with the specified value

Declaration

private static Date set(Date date, int calendarField, int amount) 

Method Source Code

//package com.java2s;
/*//from w w w. j a v a  2 s.  c  o  m
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import java.util.Calendar;
import java.util.Date;

public class Main {
    /**
     * Sets the specified field to a date returning a new object.  
     * This does not use a lenient calendar.
     * The original {@code Date} is unchanged.
     *
     * @param date  the date, not null
     * @param calendarField  the {@code Calendar} field to set the amount to
     * @param amount the amount to set
     * @return a new {@code Date} set with the specified value
     * @throws IllegalArgumentException if the date is null
     * @since 2.4
     */
    private static Date set(Date date, int calendarField, int amount) {
        if (date == null) {
            throw new IllegalArgumentException("The date must not be null");
        }
        // getInstance() returns a new object, so this method is thread safe.
        Calendar c = Calendar.getInstance();
        c.setLenient(false);
        c.setTime(date);
        c.set(calendarField, amount);
        return c.getTime();
    }
}

Related

1. ceiling(Calendar date, int field)
2. ceiling(Date date, int field)
3. ceiling(Object date, int field)
4. offsetDay(Date date, int offset)
5. offsetHour(Date date, int offset)
6. setDays(Date date, int amount)
7. setHour(Date date, int hours)
8. setHours(Date date, int amount)
9. setMilliseconds(Date date, int amount)