Java中日期时间API小结

Java中为处理日期和时间提供了大量的API，确实有把一件简单的事情搞复杂的嫌疑，各种类：Date Time Timestamp Calendar...，但是如果能够看到时间处理的本质就可以轻松hold住这堆东西了。

常用的类

表示类

java.util.Date :能够准确记录到毫秒级别的时间表示类，但是其中的各种get set(修改时间或者获取时间中某一个特殊参数)都已经被废弃。
java.sql.Date :为数据库提供的日期类，继承自util包中的Date，但是这个类只能够操作日期，不能读取或者修改时间。sql和util中Date内部进行存储的long，都可以保存到毫秒级别
java.sql.Time :为数据库提供的时间类，和Date相反，它只能获取和操作时间相关的信息。
java.sql.Timestamp:时间戳，继承util.Date，它不仅能够完美支持util.Date的功能，而且可以支持到纳秒级别(10^-9 s)。

工具类

Calendar:主要用来操作一个Date类型，提供了一系列接口来获取或修改其中的信息。
TimeZone:用来配合Calendar 操作Date，主要是考虑时区的问题，值得注意的是，在Date中存储的信息是一个绝对标准时间(稍后说明)，而如果需要进行时区的转化，那么只需要配合此类即可。
SimpleDateFormat:常用的格式化Date的工具，主要是进行String和日期之间的互换。

基本概念

时间的来源

注意，这里并不是讨论一个哲学的问题，在大部分的编程语言中，我们都是采用从1970-01-01 00:00:00.000 开始至今的毫秒差作为表示时间的数值，这个时间是绝对公立的，它和时区没有任何关系。在Java中任何时间的表示类的底层存储的毫秒数都是一个这样的标准时间。

在java中获取当前时间接口是System.currentTimeMillis()。

值得一提的是Java还提供了一个更加精确的时间：System.nanoTime()，获取一个时间精确到纳秒，但是它并不是一个当前的精确时间，而是JVM提供的一个时间，它的主要用途是来精确衡量两个时间段之间的时间，如计算一段代码的执行时间：

    long startTime = System.nanoTime();
   // ... the code being measured ...
   long estimatedTime = System.nanoTime() - startTime;

可以比较两个接口返回的内容： System.currentTimeMillis():1429108246639 System.nanoTime():1429108246640(ms)089000——->多了6位

UTC和GMT

这两个标准唯一不同之处在于UTC是基于GMT进行微调之后的一个时间，本文不去深究这两者的差别，在此认为这两者是一个东西。

初中地理教过我们，地球是24个时区，东部和西部各12个，时区的基准点是伦敦(基准UTC)，往东，会领先UTC，往西，会落后UTC。

如北京属于东八区，那么我们的时间会领先基准，也就是我们在早上9点时，伦敦是早上1点。如果我们在不同时区接发邮件的时候，可以发现这个问题。

这个时间是我收到一份来自华盛顿的邮件的时间：

2014年1月23日(星期四) 晚上7:29 (UTC-05:00 华盛顿、多伦多、古巴、智利时间)

这里我们可以在邮件时间后面发现UTC-05:00，说明这里是落后UTC基准5个小时。注意，前面的时间是发件人的本地时间，如果转化成北京所在时区的时间应该是加上13h，那我收到这封邮件的本地时间是：2014-01-24 星期五早上8:29。

再谈TimeStamp

前面说了，TimeStamp能够精确到纳秒，那它是怎么做到的呢？由于TimeStamp继承自Date，它把整数秒存储在超类中，而在子类中专门用一个long类型存储零的秒数:nanos

需要注意，除非你显示去调用TimeStamp的这个构造器: public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)

显示去指定nano的值，否则这个构造器的参数 public Timestamp(long time)

的单位实际上是毫秒。

API的使用

最后再来说说日期时间的操作接口，过程基本如下图：

           SimpleDateFormat <------>  Date   <---------> Calendar

Date负责存储一个绝对时间，并对两边提供操作接口。Calendar负责对Date中特定信息，比如这个时间是改年的第几个星期，此外，还可以通过set,add,roll接口来进行日期时间的增减。SimpleDateFormat主要作为一些格式化的输入输出。

SimpleDateFormat

SimpleDateFormat的构造器接受一个String pattern，其中的pattern是预定义的：

G 年代标志符
y 年
M 月
d 日
h 时 在上午或下午 (1~12)
H 时 在一天中 (0~23)
m 分
s 秒
S 毫秒
E 星期
D 一年中的第几天
F 一月中第几个星期几
w 一年中第几个星期
W 一月中第几个星期
a 上午 / 下午 标记符 
k 时 在一天中 (1~24)
K 时 在上午或下午 (0~11)
z 时区

例子1：

 SimpleDateFormat DATETIME_FORMATER_WITHWEEK = new SimpleDateFormat(
            "yyyy-MM-dd E HH:mm");

    java.util.Date date = new java.util.Date();
    System.out.println(DATETIME_FORMATER_WITHWEEK.format(date));

    //output: 2015-04-15 星期三 23:59 
    //当然，反过来，我也可以使用这个format将output的字符串转化成Date

Calendar

Calendar中主要需要了解的各种操作域，感觉这也是Java在做这个API时的一个败笔，灵活有余，可控性不足，初学者如果乱用域，将会产生各种bug。至于每一个域对应的时间分量，请自行google。

一些常用的filed：

YEAR:年
MONTH：月（从0 开始，0 表示1月….11表示12月）
DAY_OF_MONTH :几号（等同DATE）
DAY_OF_WEEK：星期几
DAY_OF_YEAR：年里面的天
DATE:几号（等同DAY_OF_MONTH）

一个filed通常来说对应了日期时间中的某一个分量，在操作这个分类有些操作会向高位进位，而有的操作则不会【bug高发区域】。

例子2：

SimpleDateFormat DATETIME_FORMATER_WITHWEEK = new SimpleDateFormat(
     "yyyy-MM-dd E");
    Calendar calendarT = Calendar.getInstance(Locale.CHINA);
    System.out.println(DATETIME_FORMATER_WITHWEEK.format(calendarT.getTime()));
    calendarT.set(Calendar.MONTH,12);// 月份进位
    System.out.println(DATETIME_FORMATER_WITHWEEK.format(calendarT.getTime()));
    //output:   2015-04-16 星期四
                    2016-01-16 星期六

例子3：

        SimpleDateFormat DATETIME_FORMATER_WITHWEEK = new SimpleDateFormat(
     "yyyy-MM-dd E");
    Calendar calendarT = Calendar.getInstance(Locale.CHINA);
    System.out.println("原始    :"+DATETIME_FORMATER_WITHWEEK.format(calendarT.getTime()));
    calendarT.set(Calendar.DAY_OF_MONTH,1);// 当月第一天
    System.out.println("当月第一天:"+DATETIME_FORMATER_WITHWEEK.format(calendarT.getTime()));
    //roll不会进位
    calendarT.roll(Calendar.DATE,-1);
    System.out.println("roll -1:"+DATETIME_FORMATER_WITHWEEK.format(calendarT.getTime()));
    calendarT.set(Calendar.DAY_OF_MONTH,1);// 当月第一天
    calendarT.add(Calendar.DATE,-1);
    //add产生进位
    System.out.println("add -1:"+DATETIME_FORMATER_WITHWEEK.format(calendarT.getTime()));

    //output:原始    :2015-04-16 星期四
                当月第一天:2015-04-01 星期三
                roll -1:2015-04-30 星期四
                add -1:2015-03-31 星期二

最后还是需要说明一点，获取当前时间指的是当前本地时间对应的UTC时间，和时区没有关系！有点绕，没关系看代码：

例子4：

Calendar calendar1 = Calendar.getInstance(Locale.CHINA);
    Calendar calendar2 = Calendar.getInstance(Locale.GERMAN);
    System.out.println(calendar1.getTimeInMillis());
    System.out.println(calendar2.getTimeInMillis());

    //output:
        1429115150117
        1429115150117

最后贴一个日期处理开源库：joda-time

楚云之南

先解决问题再写代码