Calendar类set（）、add（）、roll（）方法区别

1、set方法
Calendar类的MONTH是从0开始；
public class CalendarDemo {
    public static void main(String[] args) {
        Calendar cal = Calendar.getInstance();
          cal.set(2009, 0, 31);
          cal.set(Calendar.MONTH, 3);
          Date testDate = cal.getTime();
          System.out.println(testDate);
          }
结果输出为：Fri May 01 16:14:14 CST 2009；

从结果可以看出set方法会根据自然月的最大天数和传入的DAY调整日期，如上代码，四月份最大天数是4-30，所以set方法会将月份增加即五月份即5-01。

2、add方法
public class CalendarDemo {
    public static void main(String[] args) {
        Calendar cal = Calendar.getInstance();
          cal.set(2009, 0, 31);
          Date testDate = cal.getTime();
         
          Calendar cal1 = Calendar.getInstance();
          cal1.setTime(testDate);
          cal1.add(Calendar.MONTH,3);
          Date testDate1 = cal1.getTime();
          System.out.println(testDate1);
    }

}
输出结果为：Thu Apr 30 16:23:14 CST 2009；

从结果可以看出add方法会根据自然月的最大天数调整日期，如上代码，add方法不会根据传入的DAY值调整月份，而是会根据月份调整传入的DAY；

3、roll方法

public class CalendarDemo {
    public static void main(String[] args) {
        Calendar cal = Calendar.getInstance();
          cal.set(2009, 0, 31);
          Date testDate = cal.getTime();
         
          Calendar cal1 = Calendar.getInstance();
          cal1.setTime(testDate);
          cal1.roll(Calendar.MONTH, 13);
          Date testDate1 = cal1.getTime();
          System.out.println(testDate1);
    }

}

结果输出为：Sat Feb 28 16:38:18 CST 2009；

注意看年份，在加了13个月之后仍然是2009年，所以roll方法不会改变当前日期的最大年份，
而是会根据月份的总数减去12作为当前日历的月份，在调整月份日期方面和add方法相同。

下面是API（中文文档）对以上三个方法的介绍：
       可以使用三种方法更改日历字段： set()、 add() 和 roll()。

set(f, value) 将日历字段 f 更改为 value。此外，它设置了一个内部成员变量，以指示日历字段 f

已经被更改。尽管日历字段 f 是立即更改的，但是直到下次调用 get()、getTime()、

getTimeInMillis()、add() 或 roll() 时才会重新计算日历的时间值（以毫秒为单位）。因

此，多次调用 set() 不会触发多次不必要的计算。使用 set() 更改日历字段的结果是，其他日

历字段也可能发生更改，这取决于日历字段、日历字段值和日历系统。此外，在重新计算日历

字段之后，get(f) 没必要通过调用 set 方法返回 value 集合。具体细节是通过具体的日历类确

定的。

示例：假定 GregorianCalendar 最初被设置为 1999 年 8 月 31 日。调用 set(Calendar.MONTH,

Calendar.SEPTEMBER) 将该日期设置为 1999 年 9 月 31 日。如果随后调用 getTime()，那么这

是解析 1999 年 10 月 1 日的一个暂时内部表示。但是，在调用 getTime() 之前调用 set(Calen

dar.DAY_OF_MONTH, 30) 会将该日期设置为 1999 年 9 月 30 日，因为在调用 set() 之后没有发

生重新计算。

add(f, delta) 将 delta 添加到 f 字段中。这等同于调用 set(f, get(f) + delta)，但要带

以下两个调整：

Add 规则 1。调用后 f 字段的值减去调用前 f 字段的值等于 delta，以字段 f 中发

生的任何溢出为模。溢出发生在字段值超出其范围时，结果，下一个更大的字段会

递增或递减，并将字段值调整回其范围内。

Add 规则 2。如果期望某一个更小的字段是不变的，但让它等于以前的值是不可能

的，因为在字段 f 发生更改之后，或者在出现其他约束之后，比如时区偏移量发生

更改，它的最大值和最小值也在发生更改，然后它的值被调整为尽量接近于所期望

的值。更小的字段表示一个更小的时间单元。HOUR 是一个比 DAY_OF_MONTH 小的字

段。对于不期望是不变字段的更小字段，无需进行任何调整。日历系统会确定期望

不变的那些字段。

此外，与 set() 不同，add() 强迫日历系统立即重新计算日历的毫秒数和所有字段。

示例：假定 GregorianCalendar 最初被设置为 1999 年 8 月 31 日。调用 add(Calendar.MONTH,

13) 将日历设置为 2000 年 9 月 30 日。Add 规则 1 将 MONTH 字段设置为 September，因为向

August 添加 13 个月得出的就是下一年的 September。因为在 GregorianCalendar 中，DAY_OF_

MONTH 不可能是 9 月 31 日，所以 add 规则 2 将 DAY_OF_MONTH 设置为 30，即最可能的值。尽

管它是一个更小的字段，但不能根据规则 2 调整 DAY_OF_WEEK，因为在 GregorianCalendar 中

的月份发生变化时，该值也需要发生变化。

roll(f, delta) 将 delta 添加到 f 字段中，但不更改更大的字段。这等同于调用 add(f, del

ta)，但要带以下调整：

Roll 规则。在完成调用后，更大的字段无变化。更大的字段表示一个更大的时间单

元。DAY_OF_MONTH 是一个比 HOUR 大的字段。

示例：请参阅 GregorianCalendar.roll(int, int)。

使用模型。为了帮助理解 add() 和 roll() 的行为，假定有一个用户界面组件，它带有用于月、

日、年和底层 GregorianCalendar 的递增或递减按钮。如果从界面上读取的日期为 1999 年 1

月 31 日，并且用户按下月份的递增按钮，那么应该得到什么？如果底层实现使用 set()，那么

可以将该日期读为 1999 年 3 月 3 日。更好的结果是 1999 年 2 月 28 日。此外，如果用户再次

按下月份的递增按钮，那么该日期应该读为 1999 年 3 月 31 日，而不是 1999 年 3 月 28 日。

通过保存原始日期并使用 add() 或 roll()，根据是否会影响更大的字段，用户界面可以像大多

数用户所期望的那样运行。