本章介绍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' 都被保留）：
| 字母 | 日期或时间元素 | 表示 | 示例 |
|---|---|---|---|
G |
Era 标志符 | Text | AD |
y |
年 | Year | 1996; 96 |
M |
年中的月份 | Month | July; Jul; 07 |
w |
年中的周数 | Number | 27 |
W |
月份中的周数 | Number | 2 |
D |
年中的天数 | Number | 189 |
d |
月份中的天数 | Number | 10 |
F |
月份中的星期 | Number | 2 |
E |
星期中的天数 | Text | Tuesday; Tue |
a |
Am/pm 标记 | Text | PM |
H |
一天中的小时数（0-23） | Number | 0 |
k |
一天中的小时数（1-24） | Number | 24 |
K |
am/pm 中的小时数（0-11） | Number | 0 |
h |
am/pm 中的小时数（1-12） | Number | 12 |
m |
小时中的分钟数 | Number | 30 |
s |
分钟中的秒数 | Number | 55 |
S |
毫秒数 | Number | 978 |
z |
时区 | General time zone | Pacific Standard Time; PST; GMT-08:00 |
Z |
时区 | RFC 822 time zone | -0800 |
模式字母通常是重复的，其数量确定其精确表示：
- 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 日。
SimpleDateFormat 还支持本地化日期和时间模式 字符串。在这些字符串中，以上所述的模式字母可以用其他与语言环境有关的模式字母来替换。SimpleDateFormat 不处理除模式字母之外的文本本地化；而由类的客户端来处理。
示例
以下示例显示了如何在美国语言环境中解释日期和时间模式。给定的日期和时间为美国太平洋时区的本地时间 2001-07-04 12:08:56。
| 日期和时间模式 | 结果 |
|---|---|
"yyyy.MM.dd G 'at' HH:mm:ss z" |
2001.07.04 AD at 12:08:56 PDT |
"EEE, MMM d, ''yy" |
Wed, Jul 4, '01 |
"h:mm a" |
12:08 PM |
"hh 'o''clock' a, zzzz" |
12 o'clock PM, Pacific Daylight Time |
"K:mm a, z" |
0:08 PM, PDT |
"yyyyy.MMMMM.dd GGG hh:mm aaa" |
02001.July.04 AD 12:08 PM |
"EEE, d MMM yyyy HH:mm:ss Z" |
Wed, 4 Jul 2001 12:08:56 -0700 |
"yyMMddHHmmssZ" |
010704120856-0700 |
"yyyy-MM-dd'T'HH:mm:ss.SSSZ" |
2001-07-04T12:08:56.235-0700 |
日期格式是不同步的。建议为每个线程创建独立的格式实例。如果多个线程同时访问一个格式，则它必须是外部同步的。
SimpleDateFormat 示例
下面，我们通过实例学习如何使用SimpleDateFormat。
源码如下(SimpleDateFormatTest.java)：
1 import java.util.Date; 2 import java.util.Locale; 3 import java.util.Calendar; 4 import java.text.DateFormat; 5 import java.text.SimpleDateFormat; 6 7 /** 8 * SimpleDateFormat 的API测试程序 9 * 10 * @author skywang 11 * @email kuiwu-wang@163.com 12 */ 13 public class SimpleDateFormatTest { 14 15 public static void main(String[] args) { 16 17 // 通过SimpleDateFormat 获取日期/时间：有多种格式 18 testSimpleDateFormats() ; 19 20 // 通过DateFormat 获取日期/时间 21 superTest() ; 22 } 23 24 /** 25 * 通过SimpleDateFormat 获取日期/时间。有多种格式可以选择 26 */ 27 private static void testSimpleDateFormats() { 28 String[] formats = new String[] { 29 "HH:mm", // 14:22 30 "h:mm a", // 2:22 下午 31 "HH:mm z", // 14:22 CST 32 "HH:mm Z", // 14:22 +0800 33 "HH:mm zzzz", // 14:22 中国标准时间 34 "HH:mm:ss", // 14:22:30 35 "yyyy-MM-dd", // 2013-09-19 36 "yyyy-MM-dd HH:mm", // 2013-09-19 14:22 37 "yyyy-MM-dd HH:mm:ss", // 2013-09-19 14:22:30 38 "yyyy-MM-dd HH:mm:ss zzzz", // 2013-09-19 14:22:30 中国标准时间 39 "EEEE yyyy-MM-dd HH:mm:ss zzzz", // 星期四 2013-09-19 14:22:30 中国标准时间 40 "yyyy-MM-dd HH:mm:ss.SSSZ", // 2013-09-19 14:22:30.000+0800 41 "yyyy-MM-dd'T'HH:mm:ss.SSSZ", // 2013-09-19T14:22:30.000+0800 42 "yyyy.MM.dd G 'at' HH:mm:ss z", // 2013.09.19 公元 at 14:22:30 CST 43 "K:mm a", // 2:22 下午, CST 44 "EEE, MMM d, ''yy", // 星期四, 九月 19, '13 45 "hh 'o''clock' a, zzzz", // 02 o'clock 下午, 中国标准时间 46 "yyyyy.MMMMM.dd GGG hh:mm aaa", // 02013.九月.19 公元 02:22 下午 47 "EEE, d MMM yyyy HH:mm:ss Z", // 星期四, 19 九月 2013 14:22:30 +0800 48 "yyMMddHHmmssZ", // 130919142230+0800 49 "yyyy-MM-dd'T'HH:mm:ss.SSSZ", // 2013-09-19T14:22:30.000+0800 50 "EEEE 'DATE('yyyy-MM-dd')' 'TIME('HH:mm:ss')' zzzz", // 星期四 2013-09-19 14:22:30 中国标准时间 51 }; 52 53 //Date date = (new Date(0)); // date为1970-01-01 07:00:00 54 //Date date = Calendar.getInstance().getTime(); // date为当前时间 55 Date date = new Date(113, 8, 19, 14, 22, 30); // date为2013-09-19 14:22:30 56 for (String format : formats) { 57 SimpleDateFormat sdf = new SimpleDateFormat(format, Locale.SIMPLIFIED_CHINESE); 58 //SimpleDateFormat sdf = new SimpleDateFormat(format); 59 System.out.format("%30s %s\n", format, sdf.format(date)); 60 } 61 } 62 63 /** 64 * 通过DateFormat 获取日期/时间 65 */ 66 private static void superTest() { 67 // 新建date对象，时间是2013-09-19 14:22:30 68 // (01) 年=“‘目标年’ - 1900”， 69 // (02) 月。 0是一月，1是二月，依次类推。 70 // (03) 日。 1-31之间的数 71 Date mDate = new Date(113, 8, 19, 14, 22, 30); 72 Locale locale = new Locale("zh", "CN"); 73 74 // 14:22:30 75 String time = DateFormat.getTimeInstance( DateFormat.MEDIUM, Locale.SIMPLIFIED_CHINESE).format(mDate); 76 // 2013-09-19 77 String date = DateFormat.getDateInstance( DateFormat.MEDIUM, Locale.SIMPLIFIED_CHINESE).format(mDate); 78 // 2013-09-19 14:22:30 79 String datetime = DateFormat.getDateTimeInstance( DateFormat.MEDIUM, DateFormat.MEDIUM, Locale.SIMPLIFIED_CHINESE).format(mDate); 80 81 System.out.printf("\ntime=%s\ndate=%s\ndatetime=%s\n",time,date,datetime); 82 } 83 }
运行结果：
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
更多内容
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(1) Calendar
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(2) 自己封装的Calendar接口
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(3) Date
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(4) DateFormat
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(5) SimpleDateFormat
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(6) Locale
Java Calendar,Date,DateFormat,TimeZone,Locale等时间相关内容的认知和使用(7) TimeZone
