java时间----java.util.Calendar

java.util.Calendar

在java中时间的类有几个，但是随着Date被渐渐禁用，其中的方法慢慢打上了叉号，剩下能用的函数在Calendar中都已实现，而Calendar的子类GregorianCalendar又过于深入特殊日历的研究，平时我们并不会用到这个子类。我们可以相信Calendar类会是以后的主流时间类，下面我们就一起看一下Calendar类的详细内容，如果有错误欢迎大家指正。

（一） 实例化

Calendar类是一个抽象类，是不能实例化的，那么这个类得到一个日历实例的方法有这么两种：

  Calendar calendar = Calendar.getInstance(TimeZone zone , Locale locale); 

通过调用getInstance方法，选择默认的Timezone和Locale属性，从而返回一个日历,也可以在其中加上参数Timezone或Locale从而选择地域地点，具体的参数要去看java.util.Timezone，java.util.Locale这两个包，一般的默认时间是公用的时间我们其实并不需要改动。

除此之外，还有一个能够实例化的方法。没什么稀奇的，java的老套路用子类来实例化。Calendar的子类只有一个——GregorianCalendar，翻译过来就是公历的意思，这个GregorianCalendar我们以后还会单讲。实例化的第二种方式如下：

Calendar calendar = new GregorianCalendar();

（二） 类变量

Calendar中变量基本都用final限定，这些变量将年份，月份，小时，上下午等等所有的时间内容全部包括了。百度上一找一大堆，这种具体要用的时候最好还是看API，我这里姑且简要粘贴一份：

calendar.get(Calendar.YEAR);  
calendar.get(Calendar.MONTH); // 月份从0开始 
calendar.get(Calendar.DAY_OF_MONTH);   
calendar.get(Calendar.DAY_OF_WEEK);  
calendar.get(Calendar.WEEK_OF_YEAR);  
calendar.get(Calendar.WEEK_OF_MONTH);  
calendar.get(Calendar.HOUR);        // 12小时
calendar.get(Calendar.HOUR_OF_DAY); // 24小时 
calendar.get(Calendar.MINUTE);  
calendar.get(Calendar.SECOND);  
calendar.get(Calendar.MILLISECOND);  

这些值在jdk的源码中都是final变量，既然是int static final修饰，也就是说明这些变量都是有int类型的初始值的。的确如此，Calendar类中为这些变量依次编号，作为一些函数传入参数时的范围判断。那么一不小心有可能会出现这种情况，比如以下代码：

System.out.println(Calendar.DAY_OF_MOUTH);

输出的是5，尽管今天并不是这个月的5号。这其实是一个错误，其实你输出的是这个类中DAY_OF_MOUTH的初始值5，如果你要表示当前月的日期，一定要将类实例出对象，但是在类的变量可以直接点出来的类中，这种错误的发生还是很常见的。正确的方法应该用get()方法来获取(calendar是我们实例的对象)：

System.out.println(calendar.get(Calendar.DAY_OF_MOUTH));

（三） compareTo() after() before() 函数

compareTo（Calendar othercalendar），返回int值，如果对象的时间在参数时间之后返回一个大于0的数字，否则返回一个小于0的数字，特别的，如果时间相同返回0，我觉得这个方法的实现可能直接是返回了毫秒数做个差（感觉自己推测好有道理…），毫秒的差值来做返回值。
after（Calendar othercalendar），before（Calendar othercalendar），这两个函数也很好猜测，返回的是boolean值，after()函数如果时间在参数之后返回正值，before()函数时间在参数之前返回正值。

Calendar calendar = Calendar.getInstance();
Calendar calendarother = Calendar.getInstance();
calendarother.add(Calendar.DATE, -20);

if(calendar.after(calendarother))
    System.out.println("after");

calendarother.add(Calendar.DATE, 100);

if(calendar.before(calendarother))
    System.out.println("before");
if(calendar.compareTo(calendarother)>0)
        System.out.println(calendar.getTime()+">"+calendarother.getTime());

输出的结果是：

after
before
Sun Jan 11 21:19:49 GMT+08:00 1970>Thu Jan 01 00:00:00 GMT+08:00 1970

（四） get() add() set() setTime() 函数

上面的例子中出现了add(int field, int amount)这个函数，这个函数的功能比较强大，可以对第一个参数的值进行加减，从而修改这个日历实体中对应项的数值。

Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DATE, -1);
System.out.println(calendar.getTime());//输出的日期是当前日期的前一天，其他所有的都不变

get(int field)这个没有什么好说的，把要取得值放进去显示出来，如是而已,顺便提一句getTimeInMillis()，返回毫秒数，实际应用中，这个毫秒数用的还是比较多的。
set()方法有很多组参数输入方式，写的上就看得懂，setTime()这个函数将一个Date对象放进去，返回一个按照Date的日期设置日历。另外特殊需要注意的地方就是，月份是从0开始算的，把月份设置为0实际是一月份，设置为1实际为二月份，一周的第1天是星期日，第7天是星期六。

calendar.get(Calendar.DATE);
calendar.getTimeInMillis();

calendar.set(field, value);
calendar.set(year, month, date);//月份是从0开始，下同
calendar.set(year, month, date, hourOfDay, minute);
calendar.set(year, month, date, hourOfDay, minute, second);

calendar.setTime(Date date);//Date对象

（五） getTime() clear() isSet() 函数

getTime()函数是返回一个时间，大概是这个格式的

Sun Jan 11 21:19:49 GMT+08:00 1970

可以用时间格式化的方法来变成自己喜欢的样子，具体看我的另外的博客，这个函数也没有太多的槽点。clear()函数在无参数的情况下是对对象中的所有变量进行清空，清空后的时间直接打回原形，变为

Thu Jan 01 00:00:00 GMT+08:00 1970

clear()也可以附带上参数int field，表示单单清除这个数值：

calendar.clear(Calendar.YEAR);
System.out.println(calendar.getTime());

上述代码最后显示的年份是1970年（不可能清除成0000年…），其他的也可以以此类推。
isSet()方法确定日历字段是否已经设置了一个值，有些值会因为get方法触发计算而被设置，很多的时候，只要进行了初始化，很多值已经被设置了，但是作为一个boolean返回值的函数，检测的时候我们相信还是会起到作用的。

if(calendar.isSet(Calendar.DATE))

（六） 总结

Calendar类正如其名，可以实现一个日历，对其进行操作且功能较为完整。如果你只是需要一个时间，这个类并不一定比new Date()能快多少，但是对于一些细节的操作，还是有很多值得我们学习的地方。