Java Date 和 Calendar

Java 语言的Date(日期)，Calendar(日历)，DateFormat(日期格式)组成了Java标准的一个基本但是非常重要的部分。日期是商业逻辑 计算一个关键的部分，所有的开发者都应该能够计算未来的日期，定制日期的显示格式，并将文本数据解析成日期对象。 

创建一个日期对象 

让我们看一个使用系统的当前日期和时间创建一个日期对象并返回一个长整数，这个时间通常被称为Java 虚拟机(JVM)主机环境的系统时间。

import java.util.Date;

public class DateTest {
    public static void main(String[] args) {
        Date date = new Date();
        System.out.println(date);               // Fri Mar 02 22:38:41 CST 2012
        System.out.println(date.getTime());     // 1330699121772
    }
}

在星期五，2012年3月2日，下午大约是22:38:41的样子，上面的例子在系统输出设备上显示的结果是 1330699121772。 值得注意的是我们使用了Date 构造函数创建一个日期对象，这个构造函数没有接受任何参数，而这个构造函数在内部使用了System.currentTimeMillis() 方法来从系统获取日期。现在我们已经知道了如何获取从1970年1月1日开始经历的毫秒数了。我们如何才能以一种用户明白的格式来显示这个日期呢? 在这里类java.text.SimpleDateFormat 和它的抽象基类 java.text.DateFormat 就派得上用场了。 

日期数据的定制格式 

假如我们希望定制日期数据的格式，比方星期五-3月-02日-2012年. 下面的例子展示了如何完成这个工作: 

import java.text.SimpleDateFormat;
import java.util.Date;

public class DateTest {
    public static void main(String[] args) {
        Date date = new Date();

        SimpleDateFormat dateFormat = new SimpleDateFormat("EEEE-MMMM-dd-yyyy");
        System.out.println(dateFormat.format(date));                // Friday-March-02-2012
    }
}

只要通过向SimpleDateFormat 的构造函数传递格式字符串"EEE-MMMM-dd-yyyy"，我们就能够指明自己想要的格式。格式字符串中的ASCII 字符告诉格式化函数下面显示日期数据的哪一个部分。EEEE是星期，MMMM是月，dd是日，yyyy是年，字符的个数决定了日期是如何格式化的。传递"EE-MM-dd-yy"会显示 Friday-March-02-2012。 

将文本数据解析成日期对象 

假 设我们有一个文本字符串包含了一个格式化了的日期对象，我们希望解析这个字符串并从文本日期数据创建一个日期对象。我们将再次以格式化字符串"MM- dd-yyyy" 调用SimpleDateFormat类。但是这一次，我们使用格式化解析而不是生成一个文本日期数据。我们的例子显示在下面，将解析文本字符串"3-02-2012"并创建一个值为1330617600000 的日期对象。

import java.text.SimpleDateFormat;
import java.util.Date;

public class DateTest {
    public static void main(String[] args) {
        SimpleDateFormat dateFormat = new SimpleDateFormat("MM-dd-yyyy");
        String txtDate = "3-02-2012";

        try {
            Date date = dateFormat.parse(txtDate);
            System.out.println(date.getTime());                 // 1330617600000
            System.out.println(dateFormat.format(date));        // 03-02-2012
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }
    }
}

 

使用标准的日期格式化过程 

既 然我们已经可以生成和解析定制的日期格式了，让我们来看一看如何使用内建的格式化过程。方法 DateFormat.getDateTimeInstance() 让我们得以用几种不同的方法获得标准的日期格式化过程。下面是我们获取了六个内建的日期格式化过程。它们包括一个空，默认，短的，中等的，长的，完整的日期格式。 

import java.text.DateFormat;
import java.util.Date;

public class DateTest {
    public static void main(String[] args) {
        String strDate = null;

        Date date = new Date();
        System.out.println(date);           // Fri Mar 02 21:43:55 CST 2012

        strDate = DateFormat.getDateInstance().format(date);
        System.out.println(strDate);        // Mar 2, 2012


        // Date
        strDate = DateFormat.getDateInstance(DateFormat.DEFAULT).format(date);
        System.out.println(strDate);        // Mar 2, 2012

        strDate = DateFormat.getDateInstance(DateFormat.SHORT).format(date);
        System.out.println(strDate);        // 3/2/12

        strDate = DateFormat.getDateInstance(DateFormat.MEDIUM).format(date);
        System.out.println(strDate);        // Mar 2, 2012

        strDate = DateFormat.getDateInstance(DateFormat.LONG).format(date);
        System.out.println(strDate);        // March 2, 2012

        strDate = DateFormat.getDateInstance(DateFormat.FULL).format(date);
        System.out.println(strDate);        // Friday, March 2, 2012


        // DateTime
        strDate = DateFormat.getDateTimeInstance(DateFormat.DEFAULT, DateFormat.DEFAULT).format(date);
        System.out.println(strDate);        // Mar 2, 2012 11:06:36 PM

        strDate = DateFormat.getDateTimeInstance(DateFormat.SHORT, DateFormat.SHORT).format(date);
        System.out.println(strDate);        // 3/2/12 11:06 PM

        strDate = DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.MEDIUM).format(date);
        System.out.println(strDate);        // Mar 2, 2012 11:06:36 PM

        strDate = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG).format(date);
        System.out.println(strDate);        // March 2, 2012 11:06:36 PM CST

        strDate = DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.FULL).format(date);
        System.out.println(strDate);        // Friday, March 2, 2012 11:06:36 PM CST
    }
}

运行结果： 
Fri Mar 02 23:06:36 CST 2012
Mar 2, 2012
Mar 2, 2012 11:06:36 PM
3/2/12 11:06 PM
Mar 2, 2012 11:06:36 PM
March 2, 2012 11:06:36 PM CST
Friday, March 2, 2012 11:06:36 PM CST
Mar 2, 2012
3/2/12
Mar 2, 2012
March 2, 2012
Friday, March 2, 2012

注 意我们在对 getDateTimeInstance的每次调用中都传递了两个值：第一个参数是日期风格，而第二个参数是时间风格。它们都是基本数据类型int(整 型)。考虑到可读性，我们使用了DateFormat 类提供的常量: DEFAULT，SHORT，MEDIUM，LONG， FULL。 

Calendar 类 

我们现在已经能够格式化并创建一个日期对象了，但是我们如何才能设置和获取日期数据的特定部分呢，比如说小时，日，分钟? 我们又如何在日期的这些部分加上或者减去值呢? 答案是使用Calendar 类。 

假设你想要设置，获取，操纵一个日期对象的各个部分，比方一个月的一天或者是一个星期的一天，为了演示这个过程，我们将使用具体的子类 java.util.GregorianCalendar。 考虑下面的例子，它计算得到下面的第十个星期五是13号。 

import java.text.DateFormat;
import java.util.Date;
import java.util.GregorianCalendar;

public class CalendarTest {
    public static void main(String[] args) {
        Date date = new Date();
        DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.FULL);
        GregorianCalendar calendar = new GregorianCalendar();

        calendar.setTime(date);
        System.out.println("System Date: " + calendar.getTime());

        calendar.set(GregorianCalendar.DAY_OF_WEEK, GregorianCalendar.FRIDAY);
        System.out.println("Day of Week to Friday: \n" + dateFormat.format(calendar.getTime()));

        int friday13Counter = 0;
        while(friday13Counter <= 10) {
            calendar.add(GregorianCalendar.DAY_OF_MONTH, 7);
            if(calendar.get(GregorianCalendar.DAY_OF_MONTH) == 13) {
                friday13Counter++;
                System.out.println(dateFormat.format(calendar.getTime()));
            }
        }
    }
}

运行结果：

System Date: Fri Mar 02 23:37:01 CST 2012
Day of Week to Friday: 
Friday, March 2, 2012
Friday, April 13, 2012
Friday, July 13, 2012
Friday, September 13, 2013
Friday, December 13, 2013
Friday, June 13, 2014
Friday, February 13, 2015
Friday, March 13, 2015
Friday, November 13, 2015
Friday, May 13, 2016
Friday, January 13, 2017
Friday, October 13, 2017

在这个例子中我们作了有趣的函数调用:

　　calendar.set(GregorianCalendar.DAY_OF_WEEK, GregorianCalendar.FRIDAY) 和 calendar.add(GregorianCalendar.DAY_OF_MONTH, 7)

set 方法能够让我们通过简单的设置星期中的哪一天这个域来将我们的时间调整为星期五。注意到这里我们使用了常量 DAY_OF_WEEK 和 FRIDAY来增强代码的可读性。

add 方法让我们能够在日期上加上数值，润年的所有复杂的计算都由这个方法自动处理。 

我们这个例子的输出结果是: 
System Date: Fri Mar 02 23:33:19 CST 2012

当我们将它设置成星期五以后就成了:

Day of Week to Friday: 
Friday, March 2, 2012
Friday, April 13, 2012
Friday, July 13, 2012
Friday, September 13, 2013
Friday, December 13, 2013
Friday, June 13, 2014
Friday, February 13, 2015
Friday, March 13, 2015
Friday, November 13, 2015
Friday, May 13, 2016
Friday, January 13, 2017
Friday, October 13, 2017

时间掌握在你的手里 

有了这些Date 和Calendar 类的例子，你应该能够使用 java.util.Date，java.text.SimpleDateFormat， java.util.GregorianCalendar 创建许多方法了。