摘要：對(duì)象由兩部分構(gòu)成字段和相對(duì)于的微秒時(shí)間差。經(jīng)過后，直接操作會(huì)產(chǎn)生不穩(wěn)定的情況。如，對(duì)嗎結(jié)果是另一個(gè)規(guī)則是，如果比它小的字段是不可變的由的實(shí)現(xiàn)類決定，那么該小字段會(huì)修正到變化最小的值。

（在文章的最后，將會(huì)介紹Date類，如果有興趣，可以直接翻到最后去閱讀）

究竟什么是一個(gè) Calendar 呢？中文的翻譯就是日歷，那我們立刻可以想到我們生活中有陽(yáng)(公)歷、陰(農(nóng))歷之分。它們的區(qū)別在哪呢？

比如有：
月份的定義 - 陽(yáng)`(公)歷 一年12 個(gè)月，每個(gè)月的天數(shù)各不同；陰(農(nóng))歷，每個(gè)月固定28天
每周的第一天 - 陽(yáng)(公)歷星期日是第一天；陰(農(nóng))歷，星期一是第一天

實(shí)際上，在歷史上有著許多種紀(jì)元的方法。它們的差異實(shí)在太大了，比如說一個(gè)人的生日是"八月八日" 那么一種可能是陽(yáng)(公)歷的八月八日，但也可以是陰(農(nóng))歷的日期。所以為了計(jì)時(shí)的統(tǒng)一，必需指定一個(gè)日歷的選擇。那現(xiàn)在最為普及和通用的日歷就是 "Gregorian Calendar"。也就是我們?cè)谥v述年份時(shí)常用 "公元幾幾年"。Calendar 抽象類定義了足夠的方法，讓我們能夠表述日歷的規(guī)則。Java 本身提供了對(duì) "Gregorian Calendar" 規(guī)則的實(shí)現(xiàn)。我們從 Calendar.getInstance() 中所獲得的實(shí)例就是一個(gè) "GreogrianCalendar" 對(duì)象(與您通過 new GregorianCalendar() 獲得的結(jié)果一致)。

下面的代碼可以證明這一點(diǎn)：

import java.io.*;
import java.util.*;

public class WhatIsCalendar
{
public static void main(String[] args) {
Calendar calendar = Calendar.getInstance();
if (calendar instanceof GregorianCalendar)
System.out.println("It is an instance of GregorianCalendar"t;
}
}

Calendar 在 Java 中是一個(gè)抽象類(Abstract Class)，GregorianCalendar 是它的一個(gè)具體實(shí)現(xiàn)。

我們也可以自己的 Calendar 實(shí)現(xiàn)類，然后將它作為 Calendar 對(duì)象返回(面向?qū)ο蟮奶匦?。在 IBM alphaWorks 上，IBM 的開發(fā)人員實(shí)現(xiàn)了多種日歷(http://www.alphaworks.ibm.com/tech/calendars)。同樣在 Internet 上，也有對(duì)中國(guó)農(nóng)歷的實(shí)現(xiàn)。本文對(duì)如何擴(kuò)展 Calendar 不作討論，大家可以通過察看上述 Calendar 的源碼來(lái)學(xué)習(xí)。

Calendar 與 Date 的轉(zhuǎn)換非常簡(jiǎn)單：

Calendar calendar = Calendar.getInstance();
// 從一個(gè) Calendar 對(duì)象中獲取 Date 對(duì)象
Date date = calendar.getTime();
// 將 Date 對(duì)象反應(yīng)到一個(gè) Calendar 對(duì)象中，
// Calendar/GregorianCalendar 沒有構(gòu)造函數(shù)可以接受 Date 對(duì)象
// 所以我們必需先獲得一個(gè)實(shí)例，然后設(shè)置 Date 對(duì)象
calendar.setTime(date);

Calendar 對(duì)象在使用時(shí)，有一些值得注意的事項(xiàng)：

Calendar 的 set() 方法

set(int field, int value) - 是用來(lái)設(shè)置"年/月/日/小時(shí)/分鐘/秒/微秒"等值

field 的定義在 Calendar 中

set(int year, int month, int day, int hour, int minute, int second) 但沒有

set(int year, int month, int day, int hour, int minute, int second, int millisecond) 前面 set(int,int,int,int,int,int) 方法不會(huì)自動(dòng)將 MilliSecond 清為 0。

另外，月份的起始值為０而不是１，所以要設(shè)置八月時(shí)，我們用７而不是8。

calendar.set(Calendar.MONTH, 7);

我們通常需要在程序邏輯中將它清為 0，否則可能會(huì)出現(xiàn)下面的情況：

import java.io.*;
import java.util.*;

public class WhatIsCalendarWrite
{
public static void main(String[] args) throws Exception{
ObjectOutputStream out =
new ObjectOutputStream(
new FileOutputStream("calendar.out"t);
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0, 0);
out.writeObject(cal1);
Calendar cal2 = Calendar.getInstance();
cal2.set(2000, 7, 1, 0, 0, 0);
cal2.set(Calendar.MILLISECOND, 0);
out.writeObject(cal2);
out.close();
}
}

我們將 Calendar 保存到文件中

import java.io.*;
import java.util.*;

public class WhatIsCalendarRead
{
public static void main(String[] args) throws Exception{
ObjectInputStream in =
new ObjectInputStream(
new FileInputStream("calendar.out"t);
Calendar cal2 = (Calendar)in.readObject();
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0, 0);
if (cal1.equals(cal2))
System.out.println("Equals"t;
else
System.out.println("NotEqual"t;
System.out.println("Old calendar "+cal2.getTime().getTime());
System.out.println("New calendar "+cal1.getTime().getTime());
cal1.set(Calendar.MILLISECOND, 0);
cal2 = (Calendar)in.readObject();
if (cal1.equals(cal2))
System.out.println("Equals"t;
else
System.out.println("NotEqual"t;
System.out.println("Processed Old calendar "+cal2.getTime().getTime());
System.out.println("Processed New calendar "+cal1.getTime().getTime());
}
}

然后再另外一個(gè)程序中取回來(lái)（模擬對(duì)數(shù)據(jù)庫(kù)的存儲(chǔ)），但是執(zhí)行的結(jié)果是：

NotEqual
Old calendar 965113200422 <------------ 最后三位的MilliSecond與當(dāng)前時(shí)間有關(guān)
New calendar 965113200059 <-----------/
Equals
Processed Old calendar 965113200000
Processed New calendar 965113200000

另外我們要注意的一點(diǎn)是，Calendar 為了性能原因?qū)?set() 方法采取延緩計(jì)算的方法。在 JavaDoc 中有下面的例子來(lái)說明這個(gè)問題：

Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 31, 0, 0 , 0); //2000-8-31
cal1.set(Calendar.MONTH, Calendar.SEPTEMBER); //應(yīng)該是 2000-9-31，也就是 2000-10-1
cal1.set(Calendar.DAY_OF_MONTH, 30); //如果 Calendar 轉(zhuǎn)化到 2000-10-1，那么現(xiàn)在的結(jié)果就該是 2000-10-30
System.out.println(cal1.getTime()); //輸出的是2000-9-30，說明 Calendar 不是馬上就刷新其內(nèi)部的記錄

在 Calendar 的方法中，get() 和 add() 會(huì)讓 Calendar 立刻刷新。Set() 的這個(gè)特性會(huì)給我們的開發(fā)帶來(lái)一些意想不到的結(jié)果。我們后面會(huì)看到這個(gè)問題。

Calendar 對(duì)象的容錯(cuò)性，Lenient 設(shè)置
我們知道特定的月份有不同的日期，當(dāng)一個(gè)用戶給出錯(cuò)誤的日期時(shí)，Calendar 如何處理的呢？

import java.io.*;
import java.util.*;

public class WhatIsCalendar
{
public static void main(String[] args) throws Exception{
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 1, 32, 0, 0, 0);
System.out.println(cal1.getTime());
cal1.setLenient(false);
cal1.set(2000, 1, 32, 0, 0, 0);
System.out.println(cal1.getTime());
}
}

它的執(zhí)行結(jié)果是：

Tue Feb 01 00:00:00 PST 2000
Exception in thread "main" java.lang.IllegalArgumentException
at java.util.GregorianCalendar.computeTime(GregorianCalendar.java:1368)
at java.util.Calendar.updateTime(Calendar.java:1508)
at java.util.Calendar.getTimeInMillis(Calendar.java:890)
at java.util.Calendar.getTime(Calendar.java:871)
at WhatIsCalendar.main(WhatIsCalendar.java:12)
當(dāng)我們?cè)O(shè)置該 Calendar 為 Lenient false 時(shí)，它會(huì)依據(jù)特定的月份檢查出錯(cuò)誤的賦值。

不穩(wěn)定的 Calendar

我們知道 Calendar 是可以被 serialize 的，但是我們要注意下面的問題

import java.io.*;
import java.util.*;

public class UnstableCalendar implements Serializable
{

public static void main(String[] args) throws Exception{
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0 , 0);
cal1.set(Calendar.MILLISECOND, 0);
ObjectOutputStream out =
new ObjectOutputStream(
new FileOutputStream("newCalendar.out"t);
out.writeObject(cal1);
out.close();
ObjectInputStream in =
new ObjectInputStream(
new FileInputStream("newCalendar.out"t);
Calendar cal2 = (Calendar)in.readObject();
cal2.set(Calendar.MILLISECOND, 0);
System.out.println(cal2.getTime());
}
}

運(yùn)行的結(jié)果竟然是: Thu Jan 01 00:00:00 PST 1970

它被復(fù)原到 EPOC 的起始點(diǎn)，我們稱該 Calendar 是處于不穩(wěn)定狀態(tài)。這個(gè)問題的根本原因是 Java 在 serialize GregorianCalendar 時(shí)沒有保存所有的信息，所以當(dāng)它被恢復(fù)到內(nèi)存中，又缺少足夠的信息時(shí)，Calendar 會(huì)被恢復(fù)到 EPOCH 的起始值。Calendar 對(duì)象由兩部分構(gòu)成：字段和相對(duì)于 EPOC 的微秒時(shí)間差。字段信息是由微秒時(shí)間差計(jì)算出的，而 set() 方法不會(huì)強(qiáng)制 Calendar 重新計(jì)算字段。這樣字段值就不對(duì)了。

下面的代碼可以解決這個(gè)問題：

import java.io.*;
import java.util.*;

public class StableCalendar implements Serializable
{

public static void main(String[] args) throws Exception{
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 1, 0, 0 , 0);
cal1.set(Calendar.MILLISECOND, 0);
ObjectOutputStream out =
new ObjectOutputStream(
new FileOutputStream("newCalendar.out"t);
out.writeObject(cal1);
out.close();
ObjectInputStream in =
new ObjectInputStream(
new FileInputStream("newCalendar.out"t);
Calendar cal2 = (Calendar)in.readObject();
cal2.get(Calendar.MILLISECOND); //先調(diào)用 get()，強(qiáng)制 Calendar 刷新
cal2.set(Calendar.MILLISECOND, 0);//再設(shè)值
System.out.println(cal2.getTime());
}
}

運(yùn)行的結(jié)果是: Tue Aug 01 00:00:00 PDT 2000

這個(gè)問題主要會(huì)影響到在 EJB 編程中，參數(shù)對(duì)象中包含 Calendar 時(shí)。經(jīng)過 Serialize/Deserialize 后，直接操作 Calendar 會(huì)產(chǎn)生不穩(wěn)定的情況。

add() 與 roll() 的區(qū)別

add() 的功能非常強(qiáng)大，add 可以對(duì) Calendar 的字段進(jìn)行計(jì)算。如果需要減去值，那么使用負(fù)數(shù)值就可以了，如 add(field, -value)。

add() 有兩條規(guī)則：

當(dāng)被修改的字段超出它可以的范圍時(shí)，那么比它大的字段會(huì)自動(dòng)修正。如：
Calendar cal1 = Calendar.getInstance();
cal1.set(2000, 7, 31, 0, 0 , 0); //2000-8-31
cal1.add(Calendar.MONTH, 1); //2000-9-31 => 2000-10-1，對(duì)嗎？
System.out.println(cal1.getTime()); //結(jié)果是 2000-9-30

另一個(gè)規(guī)則是，如果比它小的字段是不可變的（由 Calendar 的實(shí)現(xiàn)類決定），那么該小字段會(huì)修正到變化最小的值。

以上面的例子，9-31 就會(huì)變成 9-30，因?yàn)樽兓钚　?/p>

Roll() 的規(guī)則只有一條：
當(dāng)被修改的字段超出它可以的范圍時(shí)，那么比它大的字段不會(huì)被修正。如：

Calendar cal1 = Calendar.getInstance();
cal1.set(1999, 5, 6, 0, 0, 0); //1999-6-6, 周日
cal1.roll(Calendar.WEEK_OF_MONTH, -1); //1999-6-1, 周二
cal1.set(1999, 5, 6, 0, 0, 0); //1999-6-6, 周日
cal1.add(Calendar.WEEK_OF_MONTH, -1); //1999-5-30, 周日
WEEK_OF_MONTH 比 MONTH 字段小，所以 roll 不能修正 MONTH 字段。

Date類介紹

Data和Calendar類：
一、創(chuàng)建一個(gè)日期對(duì)象r

讓我們看一個(gè)使用系統(tǒng)的當(dāng)前日期和時(shí)間創(chuàng)建一個(gè)日期對(duì)象并返回一個(gè)長(zhǎng)整數(shù)的簡(jiǎn)
單例子. 這個(gè)時(shí)間通常被稱為Java 虛擬機(jī)(JVM)主機(jī)環(huán)境的系統(tǒng)時(shí)間.
import java.util.Date;

public class DateExample1 {
public static void main(String[] args) {
// Get the system date/time
Date date = new Date();

System.out.println(date.getTime());
}
}

在星期六, 2001年9月29日, 下午大約是6:50的樣子, 上面的例子在系統(tǒng)輸出設(shè)備上
顯示的結(jié)果是 1001803809710. 在這個(gè)例子中,值得注意的是我們使用了Date 構(gòu)造
函數(shù)創(chuàng)建一個(gè)日期對(duì)象, 這個(gè)構(gòu)造函數(shù)沒有接受任何參數(shù). 而這個(gè)構(gòu)造函數(shù)在內(nèi)部
使用了System.currentTimeMillis() 方法來(lái)從系統(tǒng)獲取日期.如果用

System.out.println(new Date());

則輸出形式為：Tue Nov 08 14:28:07 CST 2005

那么, 現(xiàn)在我們已經(jīng)知道了如何獲取從1970年1月1日開始經(jīng)歷的毫秒數(shù)了. 我們?nèi)?br> 何才能以一種用戶明白的格式來(lái)顯示這個(gè)日期呢? 在這里類java.text.
SimpleDateFormat 和它的抽象基類 java.text.DateFormat 就派得上用場(chǎng)了.

二、日期數(shù)據(jù)的定制格式

假如我們希望定制日期數(shù)據(jù)的格式, 比方星期六-9月-29日-2001年. 下面的例子展
示了如何完成這個(gè)工作:

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

public class DateExample2 {

public static void main(String[] args) {

SimpleDateFormat bartDateFormat =
new SimpleDateFormat("EEEE-MMMM-dd-yyyy");

Date date = new Date();

System.out.println(bartDateFormat.format(date));
}
}

只要通過向SimpleDateFormat 的構(gòu)造函數(shù)傳遞格式字符串"EEE-MMMM-dd-yyyy",
我們就能夠指明自己想要的格式. 你應(yīng)該可以看見, 格式字符串中的ASCII 字符
告訴格式化函數(shù)下面顯示日期數(shù)據(jù)的哪一個(gè)部分. EEEE是星期, MMMM是月, dd是日
, yyyy是年. 字符的個(gè)數(shù)決定了日期是如何格式化的.傳遞"EE-MM-dd-yy"會(huì)顯示
Sat-09-29-01. 請(qǐng)察看Sun 公司的Web 站點(diǎn)獲取日期格式化選項(xiàng)的完整的指示.

三、將文本數(shù)據(jù)解析成日期對(duì)象r

假設(shè)我們有一個(gè)文本字符串包含了一個(gè)格式化了的日期對(duì)象, 而我們希望解析這個(gè)
字符串并從文本日期數(shù)據(jù)創(chuàng)建一個(gè)日期對(duì)象. 我們將再次以格式化字符串
"MM-dd-yyyy" 調(diào)用SimpleDateFormat類, 但是這一次, 我們使用格式化解析而不
是生成一個(gè)文本日期數(shù)據(jù). 我們的例子, 顯示在下面, 將解析文本字符串
"9-29-2001"并創(chuàng)建一個(gè)值為001736000000 的日期對(duì)象.

例子程序:

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

public class DateExample3 {

public static void main(String[] args) {
// Create a date formatter that can parse dates of
// the form MM-dd-yyyy.
SimpleDateFormat bartDateFormat =
new SimpleDateFormat("MM-dd-yyyy");

// Create a string containing a text date to be parsed.
String dateStringToParse = "9-29-2001";

try {
// Parse the text version of the date.
// We have to perform the parse method in a
// try-catch construct in case dateStringToParse
// does not contain a date in the format we are expecting.
Date date = bartDateFormat.parse(dateStringToParse);

// Now send the parsed date as a long value
// to the system output.
System.out.println(date.getTime());
}
catch (Exception ex) {
System.out.println(ex.getMessage());
}
}
}

五、使用標(biāo)準(zhǔn)的日期格式化過程

既然我們已經(jīng)可以生成和解析定制的日期格式了, 讓我們來(lái)看一看如何使用內(nèi)建的
格式化過程. 方法 DateFormat.getDateTimeInstance() 讓我們得以用幾種不同的
方法獲得標(biāo)準(zhǔn)的日期格式化過程. 在下面的例子中, 我們獲取了四個(gè)內(nèi)建的日期格
式化過程. 它們包括一個(gè)短的, 中等的, 長(zhǎng)的, 和完整的日期格式.

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

public class DateExample4 {

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

DateFormat shortDateFormat =
DateFormat.getDateTimeInstance(
DateFormat.SHORT,
DateFormat.SHORT);

DateFormat mediumDateFormat =
DateFormat.getDateTimeInstance(
DateFormat.MEDIUM,
DateFormat.MEDIUM);

DateFormat longDateFormat =
DateFormat.getDateTimeInstance(
DateFormat.LONG,
DateFormat.LONG);

DateFormat fullDateFormat =
DateFormat.getDateTimeInstance(
DateFormat.FULL,
DateFormat.FULL);

System.out.println(shortDateFormat.format(date));
System.out.println(mediumDateFormat.format(date));
System.out.println(longDateFormat.format(date));
System.out.println(fullDateFormat.format(date));
}
}

注意我們?cè)趯?duì) getDateTimeInstance的每次調(diào)用中都傳遞了兩個(gè)值. 第一個(gè)參數(shù)
是日期風(fēng)格, 而第二個(gè)參數(shù)是時(shí)間風(fēng)格. 它們都是基本數(shù)據(jù)類型int(整型). 考慮
到可讀性, 我們使用了DateFormat 類提供的常量: SHORT, MEDIUM, LONG, 和
FULL. 要知道獲取時(shí)間和日期格式化過程的更多的方法和選項(xiàng), 請(qǐng)看Sun 公司W(wǎng)eb
站點(diǎn)上的解釋.

運(yùn)行我們的例子程序的時(shí)候, 它將向標(biāo)準(zhǔn)輸出設(shè)備輸出下面的內(nèi)容:
9/29/01 8:44 PM
Sep 29, 2001 8:44:45 PM
September 29, 2001 8:44:45 PM EDT
Saturday, September 29, 2001 8:44:45 PM EDT