java 日期格式化-- SimpleDateFormat 的使用。字符串转日期，日期转字符串

前言

SimpleDateFormat是在一定的语言环境中，使用给定的模式和默认的日期格式符号来对日期进行格式转换的类。日期和时间格式由 日期和时间模式字符串 指定。在 日期和时间模式字符串 中，未加引号的字母 'A' 到 'Z' 和 'a' 到 'z' 被解释为模式字母，用来表示日期或时间字符串元素。文本可以使用单引号 (') 引起来，以免进行解释。所有其他字符均不解释；只是在格式化时将它们简单复制到输出字符串
白话文的讲：这些A——Z，a——z这些字母(不被单引号包围的)会被特殊处理替换为对应的日期时间，其他的字符串还是原样输出。

支持的时间和日期模式

字母	含义	表示	例子
G	纪元	Text	AD
y	年份	Year	1996; 96
M/L	月份	Month	July; Jul; 07
w	一年中的第几周	Number	27
W	一个月中的第几周	Number	2
D	一年中的第几天	Number	189
d	一个月中的第几天	Number	10
F	一个月中的第几周	Number	2
E	一周的星期数	Text	Tuesday; Tue
u	一周的星期数	Number	1
a	am/pm 标记	Text	PM
H	一天中的小时数（0-23）	Number	0
k	一天中的小时数（1-24）	Number	24
K	十二小时制中的小时数（0-11）	Number	0
h	十二小时制中的小时数（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
X	时区	ISO 8601 time zone	-08; -0800; -08:00

注意： 模式中的字母是区分大小写的，并且在模式中四个字母就能表示这个类型的全长，例如我们用MMMMM来表示月份是不必要的。当然用太少的字母来解析一定的格式也是不行的，例如我们用”yyyy.MM.dd G hh:mm aaa”来解析“2017.February.04 AD 12:08 PM”字符串时会报“Unparseable date: ‘2017.February.04.04 AD 12:08 PM’”错误。

下面给出了一些常见的日期表示方式和它对应的模式：

输入的字符串	对应的模式
2001.07.04 AD at 12:08:56 PDT	yyyy.MM.dd G ‘at’ HH:mm:ss z
Wed, Jul 4, 01	EEE, MMM d, yy
12:08 PM	hh:mm a
12 o’clock PM, Pacific Daylight Time	hh ‘o”clock’ a, zzzz
0:08 PM, PDT	K:mm a, z
02001.July.04 AD 12:08 PM	yyyyy.MMMM.dd GGG hh:mm aaa
Wed, 4 Jul 2001 12:08:56 -0700	EEE, d MMM yyyy HH:mm:ss Z
010704120856-0700	yyMMddHHmmssZ
2001-07-04T12:08:56.235-0700	yyyy-MM-dd’T’HH:mm:ss.SSSZ
2001-07-04T12:08:56.235-07:00	yyyy-MM-dd’T’HH:mm:ss.SSSXXX
2001-W27-3	YYYY-‘W’ww-u

日期和时间模式(注意大小写，代表的含义是不同的)

yyyy：年
MM：月
dd：日
hh：1~12小时制(1-12)
HH：24小时制(0-23)
mm：分
ss：秒
S：毫秒
E：星期几
D：一年中的第几天
F：一月中的第几个星期(会把这个月总共过的天数除以7)
w：一年中的第几个星期
W：一月中的第几星期(会根据实际情况来算)
a：上下午标识
k：和HH差不多，表示一天24小时制(1-24)。
K：和hh差不多，表示一天12小时制(0-11)。
z：表示时区

 

 

 

实际应用

利用SimpleDateFormat进行日期转换的代码示例如下：

//output: Thu Jul 05 03:08:56 CST 2001
String string = "2001.07.04 AD at 12:08:56 PDT";
DateFormat format = new SimpleDateFormat("yyyy.MM.dd G 'at' HH:mm:ss z", Locale.ENGLISH);
Date date = format.parse(string);
System.out.println(date); 

 

因为看到了Java 8 里面对日期的格式化操作的API，回头又看了看这个以前的日期格式化。发现，文中的实例不是很全面。不符合湿胸的性格，特地来完善一下。

private static void formatDataTest() {

/*

* 日期转期望格式的字符串

*/

//HH 和 hh 的差别：前者是24小时制，后者是12小时制。

StringBuilder sb = new StringBuilder();
sb.append("yyyy年MM月dd日 HH:mm:ss")
    .append(" 上下午标志 a")
    .append(" E")
    .append(" 一年中的第D天")
    .append(" 一月中的第F个星期")
    .append(" 一年中的第w个星期")
    .append(" 一月中的第W个星期")
    .append(" Z")
    .append(" z");
SimpleDateFormat sdf = new SimpleDateFormat(sb.toString());
String dateString = sdf.format(new Date());

        /*
        * 字符串转日期
        */
        Date date;
        try {
            date = sdf.parse(dateString);
            System.out.println(date);
        } catch (ParseException e) {
            System.out.println(e.getMessage());
        }
    }}
}

运行结果：

2017年12月28日 18:21:731 上下午标志 下午 星期四 一年中的第362天 一月中的第4个星期 一年中的第52个星期 一月中的第5个星期 +0800 CST
Thu Dec 28 18:21:00 CST 2017

这里多说一句，一个月中的第几个星期，  F   这个出来的结果，不靠谱，具体我就在这多做测试啦，我是测试过，才这么说的，还是后面的那个  W  靠谱。

（更新完成）

具体简单常见的实例：

package com.lxk.DateFormat;


import java.text.SimpleDateFormat;

import java.util.Date;


/**

* Created by lxk on 2016/11/4

*/

public class Format {

public static void main(String[] args) {

Date ss = new Date();

System.out.println("一般日期输出：" + ss);

System.out.println("时间戳：" + ss.getTime());

//Date aw = Calendar.getInstance().getTime();//获得时间的另一种方式，测试效果一样

SimpleDateFormat format0 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

String time = format0.format(ss.getTime());//这个就是把时间戳经过处理得到期望格式的时间

System.out.println("格式化结果0：" + time);

SimpleDateFormat format1 = new SimpleDateFormat("yyyy年MM月dd日 HH时mm分ss秒");

time = format1.format(ss.getTime());

System.out.println("格式化结果1：" + time);

}

}

测试结果图：

 

 

需要什么格式，自己拼好字符串，就可以格式化日期啦。授人以渔呀有木有。

上面的是：日期转自己想要的字符串格式，下面是字符串转日期类型。

private static void testStringToDate() {

String s = "2017-05-25";

SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");

Date date = null;

try {

date = format.parse(s);

} catch (ParseException e) {

System.out.println(e.getMessage());

}

System.out.println(date);

}

下面是运行的debug截图。

 

 

上面的那个  日期和时间模式  是按我们常用的年月日时分秒来放的，下面传个别人的专业的图，供参考。

定义了以下模式字母（所有其他字符 'A' 到 'Z' 和 'a' 到 'z' 都被保留）：

 

注意： 推荐使用SimpleDateFormat(String pattern, Locale locale)而不是SimpleDateFormat(String pattern)。因为当你没有指明locale的时候，会使用默认的locale，如果你输入的字符串格式与locale格式不一致时会出现java.text.ParseException 错误。

另外 SimpleDateFormat 类不都是线程安全的，在多线程环境下调用 format() 和 parse() 方法应该使用同步代码来避免问题。推荐为每个线程创建独立的格式实例，如果多个线程同时访问一个格式，则它必须保持外部同步。具体解决方法可以参考：深入理解Java：SimpleDateFormat安全的时间格式化