作爲開發者,每個開發項目中一定有很多的工具類,而其中百分之六七十就有一個DateUtils工具。每次都要寫日期格式,yyyyMMdd。每個項目項目中使用的日期格式都不一樣。終於有一天,一堆程序猿受不了了。於是把所有的日期格式都寫完。放到一個工具裏。使用就完了。文尾提供代碼。歡迎收藏使用。
一、JDK中DateTimeFormatter與SimpleDateFormat的區別
舊版的API存在線程安全的問題，所謂線程安全問題,只會存在在多線程場景下。當多個線程對同一個對象的,屬性進行修改時候,就很大機率會產生數據不同步問題，舉一個簡單的例子: A線程看到門外有一個人是小明，然後準備開門讓小明進來時候，B線程把小明拉走了，讓小張站門外了。結果導致A開門原本準備讓小明進來，結果開門小張進來了。SimpleDateFormat的問題就是這樣。format方法時候會將屬性改變從而導致線程安全。因爲現在建議使用新的日期API來替換老的。
二、 DatePatternEnum API
線程安全,使用簡單,效率更高
DatePatternEnum API
| index | pattern | desc | enum | example |
|---|---|---|---|---|
| 0 | yyyy-MM-dd HH:mm:ss | 年月日時分秒 | DATE_TIME_PATTERN | 2019-11-04 17:06:18 |
| 1 | HH:mm:ss | 時分秒 | TIME_PATTERN | 17:06:18 |
| 2 | yyyy-MM-dd HH:mm | 年月日時分 | MINUTE_PATTERN | 2019-11-04 17:06 |
| 3 | yyyy-MM-dd | 年月日 | DATE_PATTERN | 2019-11-04 |
| 4 | yyyy-MM | 年月 | MONTH_PATTERN | 2019-11 |
| 5 | yyyy | 年 | YEAR_ONLY_PATTERN | 2019 |
| 6 | MM | 月 | MONTH_ONLY_PATTERN | 11 |
| 7 | dd | 日 | DAY_ONLY_PATTERN | 04 |
| 8 | HH | 時 | HOUR_ONLY_PATTERN | 17 |
| 9 | mm | 分 | MINUTE_ONLY_PATTERN | 06 |
| 10 | ss | 秒 | SECOND_ONLY_PATTERN | 18 |
| 11 | yyyy年MM月dd日 HH時mm分ss秒 | 中文格式年月日時分秒 | ZN_DATE_TIME_PATTERN | 2019年11月04日 17時06分18秒 |
| 12 | yyyy年MM月dd日 | 中文格式年月日 | ZN_DATE_PATTERN | 2019年11月04日 |
| 13 | yyyy年MM月 | 中文格式年月 | ZN_MONTH_PATTERN | 2019年11月 |
| 14 | yyyy年 | 中文格式年 | ZN_YEAR_ONLY_PATTERN | 2019年 |
| 15 | HH時mm分ss秒 | 時分秒 | ZN_TIME_PATTERN | 17時06分18秒 |
| 16 | yyyyMMddHHmmss | 無間隔的年月日時分秒 | GAP_LESS_DATE_TIME_PATTERN | 20191104170618 |
| 17 | yyyyMMdd | 無間隔的年月日 | GAP_LESS_DATE_PATTERN | 20191104 |
| 18 | yyyy-MM-dd HH:mm:ss.SSS | 精確到毫秒 | DATE_TIME_MS_PATTERN | 2019-11-04 17:06:18.420 |
三、Code Example
對日期的處理,首先是模板,枚舉內提供了常用的日期模板,使用時候無需自己生成 SimpleDateFormat 或者是DateTimeFormatter
每個日期模板都可以直接調用 format (Date轉String) 或者 parse （String轉Date）
//①返回當前日期格式化的文本,日期表達式: DATE_TIME_PATTERN = 'yyyy-MM-dd HH:mm:ss'
System.out.println(DatePatternEnum.DATE_TIME_PATTERN.format());
//②返回當前日期格式化的文本,日期表達式: DATE_TIME_PATTERN = 'yyyy年MM月dd日 HH時mm分ss秒'
System.out.println(DatePatternEnum.ZN_DATE_TIME_PATTERN.format());
//③返回入參指定日期格式化的文本
System.out.println(DatePatternEnum.DATE_TIME_PATTERN.format(new Date()));
//④返回日期格式化工具
SimpleDateFormat dateFormat = DatePatternEnum.TIME_PATTERN.getDateFormat();
//⑤返回新JDK日期格式化工具
DateTimeFormatter dateTimeFormatter = DatePatternEnum.TIME_PATTERN.getFormatter();
四、完整代碼
import java.text.SimpleDateFormat;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.util.Date;
import java.util.Map;
import java.util.WeakHashMap;
/**
* 年-月-日 時:分:秒.毫秒->2019-11-05 17:43:29.383
* 年-月-日 時:分:秒->2019-11-05 17:43:29
* 時:分:秒->17:43:29
* 年-月-日 時:分->2019-11-05 17:43
* 年-月-日->2019-11-05
* 年-月->2019-11
* 年->2019
* 月->11
* 日->05
* 時->17
* 分->43
* 秒->29
* 中文格式年月日時分秒毫秒->2019年11月05日 17時43分29秒386毫秒
* 中文格式年月日時分秒->2019年11月05日 17時43分29秒
* 中文格式年月日->2019年11月05日
* 中文格式年月->2019年11月
* 中文格式年->2019年
* 中文格式時分秒->17時43分29秒
* 無間隔符的年月日時分秒->20191105174329
* 無間隔符的年月日時分秒毫秒->20191105174329387
* 無間隔符的年月日->20191105
*
* @author liuxin
*/
public enum DatePatternEnum {
DATE_TIME_MS_PATTERN(0, "yyyy-MM-dd HH:mm:ss.SSS", "年-月-日 時:分:秒.毫秒"),
DATE_TIME_PATTERN(1, "yyyy-MM-dd HH:mm:ss", "年-月-日 時:分:秒"),
TIME_PATTERN(2, "HH:mm:ss", "時:分:秒"),
MINUTE_PATTERN(3, "yyyy-MM-dd HH:mm", "年-月-日 時:分"),
DATE_PATTERN(4, "yyyy-MM-dd", "年-月-日"),
MONTH_PATTERN(5, "yyyy-MM", "年-月"),
ONLY_YEAR_PATTERN(6, "yyyy", "年"),
ONLY_MONTH_PATTERN(7, "MM", "月"),
ONLY_DAY_PATTERN(8, "dd", "日"),
ONLY_HOUR_PATTERN(9, "HH", "時"),
ONLY_MINUTE_PATTERN(10, "mm", "分"),
ONLY_SECOND_PATTERN(11, "ss", "秒"),
ZN_DATE_TIME_MS_PATTERN(12, "yyyy年MM月dd日 HH時mm分ss秒SSS毫秒", "中文格式年月日時分秒毫秒"),
ZN_DATE_TIME_PATTERN(13, "yyyy年MM月dd日 HH時mm分ss秒", "中文格式年月日時分秒"),
ZN_DATE_PATTERN(14, "yyyy年MM月dd日", "中文格式年月日"),
ZN_MONTH_PATTERN(15, "yyyy年MM月", "中文格式年月"),
ZN_YEAR_ONLY_PATTERN(16, "yyyy年", "中文格式年"),
ZN_TIME_PATTERN(17, "HH時mm分ss秒", "中文格式時分秒"),
GAP_LESS_DATE_TIME_PATTERN(18, "yyyyMMddHHmmss", "無間隔符的年月日時分秒"),
GAP_LESS_DATE_TIME_MS_PATTERN(19, "yyyyMMddHHmmssSSS", "無間隔符的年月日時分秒毫秒"),
GAP_LESS_DATE_PATTERN(20, "yyyyMMdd", "無間隔符的年月日");
private int index;
private String pattern;
private String desc;
private static final Map<DatePatternEnum, SimpleDateFormat> formatCache = new WeakHashMap<>(initialCapacity());
private static final Map<DatePatternEnum, DateTimeFormatter> formatterCache = new WeakHashMap<>(initialCapacity());
static {
checkCache();
}
//一個數如果是奇數的話，那麼他的二進制最後一位一定爲1,如果爲奇數+1返回
private static int initialCapacity() {
return (values().length & 1) == 1 ? values().length + 1 : values().length;
}
private static void checkCache() {
if (formatCache.isEmpty() || formatCache.size() != values().length) {
formatCache.clear();
for (DatePatternEnum datePatternEnum : values()) {
formatCache.put(datePatternEnum, new SimpleDateFormat(datePatternEnum.getPattern()));
}
}
if (formatterCache.isEmpty() || formatterCache.size() != values().length) {
formatterCache.clear();
for (DatePatternEnum datePatternEnum : values()) {
formatterCache.put(datePatternEnum, DateTimeFormatter.ofPattern(datePatternEnum.getPattern()));
}
}
}
DatePatternEnum(int index, String pattern, String desc) {
this.index = index;
this.pattern = pattern;
this.desc = desc;
}
public int getIndex() {
return index;
}
public String getPattern() {
return pattern;
}
public String getDesc() {
return desc;
}
public DateTimeFormatter getFormatter() {
checkCache();
return formatterCache.getOrDefault(this, DateTimeFormatter.ofPattern(getPattern()));
}
private SimpleDateFormat getUnSafeDateFormat() {
checkCache();
return formatCache.getOrDefault(this, new SimpleDateFormat(getPattern()));
}
public String format() {
return LocalDateTime.now().format(getFormatter());
}
public String format(Date date) {
assert date != null;
return LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault()).format(getFormatter());
}
public Date parse(String dateText) throws Exception {
return getUnSafeDateFormat().parse(dateText);
}
}