Java开发笔记（四十一）日历工具Calendar
前面的文章提到，Date是Java最早的日期工具，估计当时的设计师是个技术宅男，未经过充分调研就拍脑袋写下了Date的源码，造成该工具存在先天不足，比如getYear方法返回的不是纯正的公元纪年、getHours方法无法区分12小时制和24小时制等等，这很不利于Java语言的国际化。故而从JDK1.1开始，Java又提供了一个日历工具Calendar，官方建议采用Calendar替代Date，并且Date的相关get方法都被标记为Deprecated（意思是已废弃）。接下来就来看看这个全新的Calendar该当如何使用。
首先，创建日历实例调用的是getInstance方法，而非new关键字，日历实例的获取代码如下所示：
// 创建一个日历实例 Calendar calendar = Calendar.getInstance();
其次，调用日历实例的get方法，获得指定时间单位的具体数值，例如类型Calendar.YEAR对应的是公元年份，类型Calendar.MONTH对应的是月份序号等等，以年份为例，具体的获取代码如下所示：
// 获取日历实例中的年份
int year = calendar.get(Calendar.YEAR);
System.out.println("year="+year);
从以上代码可见，此时得到的年份数值无需额外加上1900，果然比Date省事多了。不过通过Calendar获取其它时间单位仍有两点需要注意：
1、Calendar的月份依然从0开始计数，也就是说，日历工具获取的一月份数值为0，十二月份的数值为11，于是获取月份的代码需要记得加一：
// 获取日历实例中的月份
int month = calendar.get(Calendar.MONTH)+1;
System.out.println("month="+month);
2、原来Date的星期几从0开始计数，现在Calendar的星期几改为从1开始计数，可谓一大进步，不料它的星期仍旧以星期日打头、以星期六结尾。也就是说，日历工具获取的星期日数值为1，星期一数值为2，这样一来只好由程序员手工调整，按照国人习惯把星期一对应的数值改为1、把星期日对应的数值改为7等等。修改后的星期获取代码示例如下：
// 获取日历实例中的星期几
int dayOfWeek = calendar.get(Calendar.DAY_OF_WEEK);
dayOfWeek = dayOfWeek==1 ? 7 : dayOfWeek-1;
System.out.println("dayOfWeek="+dayOfWeek);
其它的时间单位中规中矩，无需额外的处理，与Date相比，Calendar新增了类型Calendar.DAY_OF_YEAR（从年初开始数的日子），以及Calendar.MILLISECOND（秒钟后面的毫秒），另外把时钟区分为Calendar.HOUR（十二小时制的时钟数值）和Calendar.HOUR_OF_DAY（二十四小时制的时钟数值）两种类型。这些普通时间单位的获取代码如下所示：
// 获取日历实例中的日子
int dayOfMonth = calendar.get(Calendar.DAY_OF_MONTH);
System.out.println("dayOfMonth="+dayOfMonth);
// 获取日历实例中从年初开始数的日子
int dayOfYear = calendar.get(Calendar.DAY_OF_YEAR);
System.out.println("dayOfYear="+dayOfYear);
// 获取日历实例中的时钟（12小时制）
int hour = calendar.get(Calendar.HOUR);
System.out.println("hour="+hour);
// 获取日历实例中的时钟（24小时制）
int hourOfDay = calendar.get(Calendar.HOUR_OF_DAY);
System.out.println("hourOfDay="+hourOfDay);
// 获取日历实例中的分钟
int minute = calendar.get(Calendar.MINUTE);
System.out.println("minute="+minute);
// 获取日历实例中的秒钟
int second = calendar.get(Calendar.SECOND);
System.out.println("second="+second);
// 获取日历实例中的毫秒
int milliSecond = calendar.get(Calendar.MILLISECOND);
System.out.println("milliSecond="+milliSecond);
再次，Calendar提供了set方法用于设置时间数值，并且重载了参数个数不同的多种set方法，其中带三个参数的set方法支持同时设置年月日，带六个参数的set方法支持同时设置年月日、时分秒。这两种set方法的调用代码示例如下：
Calendar calendar = Calendar.getInstance(); // 调用带三个参数的set方法同时设置日历实例的年、月、日 calendar.set(2018, 11, 27); // 调用带六个参数的set方法同时设置日历实例的年、月、日、时、分、秒 calendar.set(2018, 11, 27, 12, 30, 40);
如果只想修改某个时间单位，则可调用带两个参数的set方法，第一个参数为单位类型包括Calendar.YEAR、Calendar.MONTH等等，第二个参数为具体的时间数值。比如以下的代码表示把某个日期改为当月1号：
// 带两个参数的set方法允许把某个时间单位改为指定数值
calendar.set(Calendar.DAY_OF_MONTH, 1);
System.out.println("end set dayOfMonth="+calendar.get(Calendar.DAY_OF_MONTH));
注意到以上代码设置的日期是绝对值，有时候可能需要在当前日期上增增减减，也就是设置日期的相对值，此时可以联合使用get和set方法，先通过get方法获得当前的时间数值，对当前数值增减之后再传给set方法。下面的代码便演示了设置时间相对值的实现过程：
// 联合使用get和set方法，可对某个时间单位进行增减
int dayResult = calendar.get(Calendar.HOUR_OF_DAY) + 1; // 给当前日期加上一天
calendar.set(Calendar.HOUR_OF_DAY, dayResult);
System.out.println("end set hourOfDay="+calendar.get(Calendar.HOUR_OF_DAY));
联合使用get和set方法固然实现了相对时间的修改，可是简简单单的功能还得两个步骤稍显繁琐，因此Calendar另外提供了add方法，利用add方法允许直接设置相对数值，就像下列代码示范的那样：
// 调用add方法，直接在当前时间的基础上增加若干数值
calendar.add(Calendar.MINUTE, 10); // 给当前时间加上10分钟
System.out.println("end add minute="+calendar.get(Calendar.MINUTE));
日历工具Calendar就像它的前辈Date一样，仍然保留了与时间校验相关的几个方法，包括equals、before、after、compareTo方法等，并且它们的用法与Date类型的同名方法保持一致，这里不再赘述，还是直接看下面的时间比较代码好了：
// 比较两个日历时间的先后关系
private static void compareCalendar() {
Calendar calendarOld = Calendar.getInstance();
Calendar calendarNew = Calendar.getInstance();
// 给calendarNew加上一秒
calendarNew.add(Calendar.SECOND, 1);
// 比较两个时间是否相等
boolean equals = calendarOld.equals(calendarNew);
System.out.println("equals="+equals);
// 比较A时间是否在B时间之前
boolean before = calendarOld.before(calendarNew);
System.out.println("before="+before);
// 比较A时间是否在B时间之后
boolean after = calendarOld.after(calendarNew);
System.out.println("after="+after);
// 比较A时间与B时间的先后关系。返回-1表示A时间较早，返回0表示两个时间相等，返回1表示B时间较早
int compareResult = calendarOld.compareTo(calendarNew);
System.out.println("compareResult="+compareResult);
}
更多Java技术文章参见《Java开发笔记（序）章节目录》
