java基礎系列-Calendar類
原創文章，轉載請標註出處：《Java基礎系列-Calendar類》
一、概述
Java官方推薦使用Calendar來替換Date的使用。
Calendar與Date之間可以自由的進行轉換，轉換的紐帶是time。
使用Calendar的getTime()方法可以得到一個Date型別的物件，這個物件底層是使用Date的第二個帶Long型引數的構造器建立的，這個Long型引數是Calendar中的time欄位中儲存的值，這個time欄位的值是在具體的實現類中定義賦值的。
比如GregorianCalendar中的實現computeTime()，這個方法的目的就是將field值轉換為time值，這個涉及到Calendar中的兩種模式，之後會有介紹。
而通過Calendar的setTime(Date date)方法可以將一個Date物件轉換為一個Calendar物件，這個方法以一個Date物件為引數，底層呼叫的setTimeInMillis(long millis)方法，將date.getTime()的值作為引數，再底層會將這個Long型引數值賦值給time欄位，這時會重計算field值。
Calendar與Date的轉換：
public class CalendarTest {
public static void main(String[] args) {
//Calendar--->Date
Calendar c = Calendar.getInstance();
Date d = c.getTime();
//Date--->Calendar
Date d1 = new Date();
Calendar c1 = Calendar.getInstance();
c1.setTime(d1);
System.out.println(d);
System.out.println(c1.get(Calendar.YEAR)+"年"+(c1.get(Calendar.MONTH)+1)+"月"+c1.get(Calendar.DATE)+"日");
}
}
執行結果：
Sat Jul 08 10:39:14 CST 2017 2017年7月8日
二、Calendar中的time與field
Calendar中有兩種描述時間內容的域，一種就是time，它用來儲存Calendar物件所代表的時間點據1970年1月1日 00:00:00的毫秒數，另一種就是field，它是一個數組，它表示的並不是一個內容，而是Calendar內部定義的最多靜態常量欄位。
而這一般情況下是同步的，即表述的是同一時間點，但也有可能會出現不同步的情況：
- 起初，field沒有設定，time也是無效的
- 如果time被設定，所有的field都會自動被設定為同步的時間點
- 如果某一field被單獨設定，time會自動失效
更確切的說，當我們通過Calendar.getInstance()方法獲取一個全新的Calendar物件時，它所代表的時間點是通過time來設定的，而這個time的值是通過System.currentTimeMillis()得到的，通過time定義Calendar，isTimeSet為true，表示time值是最新的（真的），areFieldsSet為false，表示field欄位的值都是舊的（假的），因為當我們重新設定了time值之後，Calendar所代表的時間點就發生了變化（這裡是首次，相當於從無到有，也算是變化，之後當我們為Calendar的time重新設定一個新值時，Calendar的時間點就會再次發生變化，它會指向最新的time值所代表的時間點），而這時field中還表示的是原來的時間點內容，然後會呼叫computeFields()方法進行所有欄位值的重計算，確保field中的值與time同步，並同時將areFieldsSet和areAllFieldsSet設定為true，表示所有的field代表的時間值也是最新的了（真）。其實我們每次更改time值都會自動觸發重計算，來確保兩個域所描述的時間點一致（即同步），這也就是上面b所述的內容。
但是如果我們通過set(int field, int value)單獨對field中的某行一欄位進行更改時，首先會觸發一個驗證，areFieldsSet為真而areAllFieldsSet為false時，表示只有一部分field是最新的情況，即存在部分field屬於舊的情況，針對這種情況會觸發field的重新計算；之後會將isTimeSet設定為false，areFieldsSet設定為false，將isSet[field]設定為true（將當前field設定為真），這種情況下，當我們使用getTime()獲取time值所代表的時間點時，由於isTimeSet為false，會觸發time的重計算，這個計算依據是根據field的值進行的，之後將isTimeSet設定為true，同樣我們在通過get(int field)獲取某個field值時也會先驗證isTimeSet是否為true，如果為false，同樣會觸發time的重計算，然後驗證areFieldsSet為false，則觸發其餘field的重計算。
time的重計算是依據field的，確切的說是依據部分field的，而有一部分field也是在field的基礎上再計算的，所以可以說有一部分field是固定的，是和time息息相關的。
以上種種所述全部是Calendar內部的實現規則，對外而言，我們只需要簡單的呼叫即可，所有這些都被隱藏在內部，從而保證我們通過對外方法獲取到的直接就是正確的值。
過程例項：
public class CalendarTest {
public static void main(String[] args) throws ParseException {
System.out.println("-------初始情況-------");
Calendar c = Calendar.getInstance();
System.out.println(c.getTime());
System.out.println(c.get(Calendar.DATE));
System.out.println(c.get(Calendar.HOUR));
System.out.println("-------重設定time-------");
c.setTime(new SimpleDateFormat("yyyyMMdd").parse("20170501"));
System.out.println(c.getTime());
System.out.println(c.get(Calendar.DATE));
System.out.println(c.get(Calendar.HOUR));
System.out.println("-------重設定field-------");
c.set(Calendar.MONTH, 4);
System.out.println(c.getTime());
System.out.println(c.get(Calendar.DATE));
System.out.println(c.get(Calendar.HOUR));
System.out.println("總結：time與field所代表時間點同步，所有的不同步全部在內部處理完成");
}
}
執行結果：
-------初始情況------- Sat Jul 08 13:08:34 CST 2017 8 1 -------重設定time------- Mon May 01 00:00:00 CST 2017 1 0 -------重設定field------- Mon May 01 00:00:00 CST 2017 1 0 總結：time與field所代表時間點同步，所有的不同步全部在內部處理完成
三、Calendar中的兩種解析模式
- lenient：該模式下可以自動規則化使用者賦值給Calendar的不規則值，比如1月32日會被解析為2月1日
- non-lenient：該模式下不會自動解析不規則的輸入，而是一旦發現不規則輸入，就會報出異常
這也叫Calendar的容錯性，lenient的開啟與關閉使用setLenient(boolean lenient)方法來設定，true表示開啟容錯性（預設情況），false表示關閉該功能。
例項：
public class CalendarTest {
public static void main(String[] args) {
Calendar c = Calendar.getInstance();
c.set(Calendar.MONTH, 8);
c.set(Calendar.DAY_OF_MONTH, 33);
System.out.println(c.getTime()+"\n");
c.setLenient(false);
c.set(Calendar.MONTH, 8);
c.set(Calendar.DAY_OF_MONTH, 33);
System.out.println(c.getTime());
}
}
執行結果：
Tue Oct 03 13:18:48 CST 2017 Exception in thread "main" java.lang.IllegalArgumentException: DAY_OF_MONTH at java.util.GregorianCalendar.computeTime(GregorianCalendar.java:2583) at java.util.Calendar.updateTime(Calendar.java:2606) at java.util.Calendar.getTimeInMillis(Calendar.java:1118) at java.util.Calendar.getTime(Calendar.java:1091) at JdkTest.main(JdkTest.java:87)
從上面的例子中可以看出，預設情況下，我們為Calendar的月份賦值為8即九月份，日期賦值為33即下一月3號，輸出為10月3日，容錯性將這種不符合規則的輸入規則化處理了，而關閉容錯性之後，同樣的賦值只會報異常java.lang.IllegalArgumentException（非法引數異常）。
四、Calendar的使用
例項：
public class CalendarTest {
public static void main(String[] args) throws ParseException {
//通過SimpleDateFormat解析日期字串
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd hh:mm:ss.SSS");
Date date = sdf.parse("20170502 13:33:23.433");
//將Date格式日期轉換成Calendar
Calendar c = Calendar.getInstance();
c.setTime(date);
//獲取時間值
System.out.println(c.getTime());
System.out.println("年份為"+c.get(Calendar.YEAR));
System.out.println("月份為"+c.get(Calendar.MONTH));
System.out.println("日期為"+c.get(Calendar.DATE));
System.out.println("日期為"+c.get(Calendar.DAY_OF_MONTH));
System.out.println("日期為"+c.get(Calendar.DAY_OF_WEEK));
System.out.println("日期為"+c.get(Calendar.DAY_OF_WEEK_IN_MONTH));
System.out.println("日期為"+c.get(Calendar.DAY_OF_YEAR));
System.out.println("時為"+c.get(Calendar.HOUR));
System.out.println("時為"+c.get(Calendar.HOUR_OF_DAY));
System.out.println("分為"+c.get(Calendar.MINUTE));
System.out.println("秒為"+c.get(Calendar.SECOND));
System.out.println("毫秒為"+c.get(Calendar.MILLISECOND));
System.out.println("星期為"+c.get(Calendar.WEEK_OF_MONTH));
System.out.println("星期為"+c.get(Calendar.WEEK_OF_YEAR));
System.out.println("歷型為"+c.get(Calendar.ERA));
System.out.println("zone為"+c.get(Calendar.ZONE_OFFSET));
//設定
c.set(Calendar.MONTH, Calendar.APRIL);
System.out.println("修改後月份為"+c.get(Calendar.MONTH));
c.set(1999, 0, 23);
System.out.println(c.getTime());
c.set(2000, 1, 12, 13, 33, 14);
System.out.println(c.getTime());
c.set(2001, 2, 13, 14, 13);
System.out.println(c.getTime());
//運算
System.out.println("-----運算-----");
c.add(Calendar.YEAR, 12);
System.out.println(c.getTime());
c.add(Calendar.MONTH, -1);
System.out.println(c.getTime());
c.roll(Calendar.DATE, true);
System.out.println(c.getTime());
c.add(Calendar.DATE, 1);
System.out.println(c.getTime());
//roll與add運算對比
c.set(2000, 1, 29);
System.out.println(c.getTime());
c.roll(Calendar.DATE, 1);
System.out.println(c.getTime());
c.set(2000, 1, 29);
c.add(Calendar.DATE, 1);
System.out.println(c.getTime());
}
}
執行結果為：
Tue May 02 13:33:23 CST 2017 年份為2017 月份為4 日期為2 日期為2 日期為3 日期為1 日期為122 時為1 時為13 分為33 秒為23 毫秒為433 星期為1 星期為18 歷型為1 zone為28800000 修改後月份為3 Sat Jan 23 13:33:23 CST 1999 Sat Feb 12 13:33:14 CST 2000 Tue Mar 13 14:13:14 CST 2001 -----運算----- Wed Mar 13 14:13:14 CST 2013 Wed Feb 13 14:13:14 CST 2013 Thu Feb 14 14:13:14 CST 2013 Fri Feb 15 14:13:14 CST 2013 Tue Feb 29 14:13:14 CST 2000 Tue Feb 01 14:13:14 CST 2000 Wed Mar 01 14:13:14 CST 2000
對比上面最後的兩行輸出，可以看出add與roll的運算規則其實是不同的，roll的運算不會影響大規則（這裡的大規則指的是月份的改變）的改變，而add會影響。
綜上所述，我們可以簡單的認識一下Calendar類，並學會簡單的使用它，對於其內部實現，還需要認真敲一敲原始碼。