前言
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安全的时间格式化