介紹SimpleDateFormat。
SimpleDateFormat 介紹
SimpleDateFormat 是一個格式化Date 以及 解析日期字符串 的工具。它的最常用途是,能夠按照指定的格式來對Date進行格式化,然後我們使用可以格式化Date後得到的字符串。
更嚴格的說,SimpleDateFormat 是一個以與語言環境有關的方式來格式化和解析日期的具體類。它允許進行格式化(日期 -> 文本)、解析(文本 -> 日期)和規范化。
SimpleDateFormat的構造函數:
// 構造函數 SimpleDateFormat() SimpleDateFormat(String pattern) SimpleDateFormat(String template, DateFormatSymbols value) SimpleDateFormat(String template, Locale locale) // 非構造函數 void applyLocalizedPattern(String template) void applyPattern(String template) Object clone() boolean equals(Object object) StringBuffer format(Date date, StringBuffer buffer, FieldPosition fieldPos) AttributedCharacterIterator formatToCharacterIterator(Object object) Date get2DigitYearStart() DateFormatSymbols getDateFormatSymbols() int hashCode() Date parse(String string, ParsePosition position) void set2DigitYearStart(Date date) void setDateFormatSymbols(DateFormatSymbols value) String toLocalizedPattern() String toPattern()
SimpleDateFormat 簡單示范:
// 新建date對象,時間是2013-09-19
Date date = new Date(113,8,19);
// 新建“SimpleDateFormat對象”,並設置 sdf 的“格式化模式”
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
// 用 sdf 格式化 date,並返回字符串。
String str = sdf.format(date);
SimpleDateFormat 相關格式說明
日期和時間模式
日期和時間格式由日期和時間模式 字符串指定。在日期和時間模式字符串中,未加引號的字母 'A' 到 'Z' 和 'a' 到 'z' 被解釋為模式字母,用來表示日期或時間字符串元素。文本可以使用單引號 (') 引起來,以免進行解釋。"''" 表示單引號。所有其他字符均不解釋;只是在格式化時將它們簡單復制到輸出字符串,或者在解析時與輸入字符串進行匹配。
定義了以下模式字母(所有其他字符 'A' 到 'Z' 和 'a' 到 'z' 都被保留):
模式字母通常是重復的,其數量確定其精確表示:
Text: 對於格式化來說,如果模式字母的數量大於等於 4,則使用完全形式;否則,在可用的情況下使用短形式或縮寫形式。對於解析來說,兩種形式都是可接受的,與模式字母的數量無關。
Number: 對於格式化來說,模式字母的數量是最小的數位,如果數位不夠,則用 0 填充以達到此數量。對於解析來說,模式字母的數量被忽略,除非必須分開兩個相鄰字段。
Year: 如果格式器的 Calendar 是格裡高利歷,則應用以下規則。
Month: 如果模式字母的數量為 3 或大於 3,則將月份解釋為 text;否則解釋為 number。
對於格式化來說,如果模式字母的數量為 2,則年份截取為 2 位數,否則將年份解釋為 number。
對於解析來說,如果模式字母的數量大於 2,則年份照字面意義進行解釋,而不管數位是多少。因此使用模式 "MM/dd/yyyy",將 "01/11/12" 解析為公元 12 年 1 月 11 日。
在解析縮寫年份模式("y" 或 "yy")時,SimpleDateFormat 必須相對於某個世紀來解釋縮寫的年份。這通過將日期調整為 SimpleDateFormat 實例創建之前的 80 年和之後 20 年范圍內來完成。例如,在 "MM/dd/yy" 模式下,如果 SimpleDateFormat 實例是在 1997 年 1 月 1 日創建的,則字符串 "01/11/12" 將被解釋為 2012 年 1 月 11 日,而字符串 "05/04/64" 將被解釋為 1964 年 5 月 4 日。在解析時,只有恰好由兩位數字組成的字符串(如 Character#isDigit(char) 所定義的)被解析為默認的世紀。其他任何數字字符串將照字面意義進行解釋,例如單數字字符串,3 個或更多數字組成的字符串,或者不都是數字的兩位數字字符串(例如"-1")。因此,在相同的模式下, "01/02/3" 或 "01/02/003" 解釋為公元 3 年 1 月 2 日。同樣,"01/02/-3" 解析為公元前 4 年 1 月 2 日。
否則,則應用日歷系統特定的形式。對於格式化和解析,如果模式字母的數量為 4 或大於 4,則使用日歷特定的 long form。否則,則使用日歷特定的 short or abbreviated form。
SimpleDateFormat 還支持本地化日期和時間模式 字符串。在這些字符串中,以上所述的模式字母可以用其他與語言環境有關的模式字母來替換。SimpleDateFormat 不處理除模式字母之外的文本本地化;而由類的客戶端來處理。
示例
以下示例顯示了如何在美國語言環境中解釋日期和時間模式。給定的日期和時間為美國太平洋時區的本地時間 2001-07-04 12:08:56。
日期格式是不同步的。建議為每個線程創建獨立的格式實例。如果多個線程同時訪問一個格式,則它必須是外部同步的。
SimpleDateFormat 示例
下面,我們通過實例學習如何使用SimpleDateFormat。
源碼如下(SimpleDateFormatTest.java):
import java.util.Date; import java.util.Locale; import java.util.Calendar; import java.text.DateFormat; import java.text.SimpleDateFormat; /** * SimpleDateFormat 的API測試程序 * * @author skywang * @email [email protected] */ public class SimpleDateFormatTest { public static void main(String[] args) { // 通過SimpleDateFormat 獲取日期/時間:有多種格式 testSimpleDateFormats() ; // 通過DateFormat 獲取日期/時間 superTest() ; } /** * 通過SimpleDateFormat 獲取日期/時間。有多種格式可以選擇 */ private static void testSimpleDateFormats() { String[] formats = new String[] { "HH:mm", // 14:22 "h:mm a", // 2:22 下午 "HH:mm z", // 14:22 CST "HH:mm Z", // 14:22 +0800 "HH:mm zzzz", // 14:22 中國標准時間 "HH:mm:ss", // 14:22:30 "yyyy-MM-dd", // 2013-09-19 "yyyy-MM-dd HH:mm", // 2013-09-19 14:22 "yyyy-MM-dd HH:mm:ss", // 2013-09-19 14:22:30 "yyyy-MM-dd HH:mm:ss zzzz", // 2013-09-19 14:22:30 中國標准時間 "EEEE yyyy-MM-dd HH:mm:ss zzzz", // 星期四 2013-09-19 14:22:30 中國標准時間 "yyyy-MM-dd HH:mm:ss.SSSZ", // 2013-09-19 14:22:30.000+0800 "yyyy-MM-dd'T'HH:mm:ss.SSSZ", // 2013-09-19T14:22:30.000+0800 "yyyy.MM.dd G 'at' HH:mm:ss z", // 2013.09.19 公元 at 14:22:30 CST "K:mm a", // 2:22 下午, CST "EEE, MMM d, ''yy", // 星期四, 九月 19, '13 "hh 'o''clock' a, zzzz", // 02 o'clock 下午, 中國標准時間 "yyyyy.MMMMM.dd GGG hh:mm aaa", // 02013.九月.19 公元 02:22 下午 "EEE, d MMM yyyy HH:mm:ss Z", // 星期四, 19 九月 2013 14:22:30 +0800 "yyMMddHHmmssZ", // 130919142230+0800 "yyyy-MM-dd'T'HH:mm:ss.SSSZ", // 2013-09-19T14:22:30.000+0800 "EEEE 'DATE('yyyy-MM-dd')' 'TIME('HH:mm:ss')' zzzz", // 星期四 2013-09-19 14:22:30 中國標准時間 }; //Date date = (new Date(0)); // date為1970-01-01 07:00:00 // 查看本欄目HH:mm 14:22 h:mm a 2:22 下午 HH:mm z 14:22 CST HH:mm Z 14:22 +0800 HH:mm zzzz 14:22 中國標准時間 HH:mm:ss 14:22:30 yyyy-MM-dd 2013-09-19 yyyy-MM-dd HH:mm 2013-09-19 14:22 yyyy-MM-dd HH:mm:ss 2013-09-19 14:22:30 yyyy-MM-dd HH:mm:ss zzzz 2013-09-19 14:22:30 中國標准時間 EEEE yyyy-MM-dd HH:mm:ss zzzz 星期四 2013-09-19 14:22:30 中國標准時間 yyyy-MM-dd HH:mm:ss.SSSZ 2013-09-19 14:22:30.000+0800 yyyy-MM-dd'T'HH:mm:ss.SSSZ 2013-09-19T14:22:30.000+0800 yyyy.MM.dd G 'at' HH:mm:ss z 2013.09.19 公元 at 14:22:30 CST K:mm a 2:22 下午 EEE, MMM d, ''yy 星期四, 九月 19, '13 hh 'o''clock' a, zzzz 02 o'clock 下午, 中國標准時間 yyyyy.MMMMM.dd GGG hh:mm aaa 02013.九月.19 公元 02:22 下午 EEE, d MMM yyyy HH:mm:ss Z 星期四, 19 九月 2013 14:22:30 +0800 yyMMddHHmmssZ 130919142230+0800 yyyy-MM-dd'T'HH:mm:ss.SSSZ 2013-09-19T14:22:30.000+0800 EEEE 'DATE('yyyy-MM-dd')' 'TIME('HH:mm:ss')' zzzz 星期四 DATE(2013-09-19) TIME(14:22:30) 中國標准時間 time=14:22:30 date=2013-9-19 datetime=2013-9-19 14:22:30