一文分享Java日期解析的完整方案(覆蓋50+種格式自動(dòng)識(shí)別)
寫后端接口，日期解析是個(gè)躲不過去的坎。
前端傳 "2024-01-15"，Excel 導(dǎo)出的文件里是 "2024/01/15"，財(cái)務(wù)系統(tǒng)對(duì)接傳的是 "20240115"，移動(dòng)端有時(shí)候還扔一個(gè) "2024年1月15日" 過來。更煩人的是，有時(shí)候同一個(gè)接口，同一個(gè)參數(shù)，上游不同調(diào)用方傳不同的格式——你得一個(gè)個(gè)兼容。
網(wǎng)上搜 “Java 日期解析”，清一色教你這么寫：
// 經(jīng)典做法：寫一堆 try-catch
public static Date parse(String dateStr) {
String[] patterns = {
"yyyy-MM-dd HH:mm:ss", "yyyy-MM-dd", "yyyy/MM/dd HH:mm:ss",
"yyyy/MM/dd", "yyyyMMddHHmmss", "yyyyMMdd",
// ... 寫幾十個(gè)
};
for (String pattern : patterns) {
try {
return DateUtil.parse(dateStr, pattern);
} catch (Exception e) { }
}
throw new IllegalArgumentException("無法解析: " + dateStr);
}
代碼冗長(zhǎng)不說，性能也有問題——解析 "2024年1月15日" 要先試前面 40 多個(gè)常規(guī)格式，每個(gè)都走一遍 DateTimeFormatter.parse，失敗、拋異常、catch 吞掉，再試下一個(gè)。
DateParserUtils 換了個(gè)思路：先看字符串有什么分隔符，直接跳到對(duì)應(yīng)格式組，不遍歷。
引入依賴
<!-- Spring Boot 2.x --> <dependency> <groupId>com.gitee.apanlh</groupId> <artifactId>apanlh-common</artifactId> <version>2.0.6</version> </dependency>
Spring Boot 3.x 項(xiàng)目：
<dependency> <groupId>com.gitee.apanlh</groupId> <artifactId>apanlh-common</artifactId> <version>3.0.6</version> </dependency>
JDK 8+ 可用，零強(qiáng)制依賴。
自動(dòng)識(shí)別，不傳 pattern
// 橫線分隔
DateParserUtils.toLocalDateTime("2024-01-15 10:30:45");
// → 2024-01-15T10:30:45
// 斜杠分隔
DateParserUtils.toLocalDateTime("2024/01/15 10:30:45");
// → 2024-01-15T10:30:45
// 點(diǎn)分隔
DateParserUtils.toLocalDateTime("2024.01.15 10:30:45");
// → 2024-01-15T10:30:45
// 緊湊格式（無分隔符）
DateParserUtils.toLocalDateTime("20240115103045");
// → 2024-01-15T10:30:45
// 中文格式
DateParserUtils.toLocalDateTime("2024年1月15日 10時(shí)30分45秒");
// → 2024-01-15T10:30:45
// ISO 格式（帶 T 和納秒）
DateParserUtils.toLocalDateTime("2024-01-15T10:30:45.123456789");
// → 2024-01-15T10:30:45.123456789
一個(gè) toLocalDateTime(String) 方法不傳 pattern，底層自動(dòng)識(shí)別不會(huì)在無效格式上浪費(fèi)時(shí)間。
純?nèi)掌凇⒓儠r(shí)間也一樣
// 日期解析 —— 同樣自動(dòng)識(shí)別
DateParserUtils.toLocalDate("2024-01-15"); // 橫線
DateParserUtils.toLocalDate("2024/01/15"); // 斜杠
DateParserUtils.toLocalDate("2024.01.15"); // 點(diǎn)
DateParserUtils.toLocalDate("2024_01_15"); // 下劃線
DateParserUtils.toLocalDate("20240115"); // 緊湊
DateParserUtils.toLocalDate("2024年1月15日"); // 中文
// 時(shí)間解析
DateParserUtils.toLocalTime("10:30:45"); // 冒號(hào)
DateParserUtils.toLocalTime("10.30.45"); // 點(diǎn)
DateParserUtils.toLocalTime("10時(shí)30分45秒"); // 中文
DateParserUtils.toLocalTime("103045"); // 緊湊
日期額外支持下劃線分隔，時(shí)間支持冒號(hào)、點(diǎn)、中文、緊湊四種格式。
tryTo* 降級(jí)：類型不兼容時(shí)自動(dòng)處理
實(shí)際開發(fā)經(jīng)常遇到：上游傳了 "2024-01-15 14:30:45"，但你的業(yè)務(wù)只需要日期。用 toLocalDate 解析會(huì)失敗，因?yàn)楦袷浇M里有時(shí)間部分。
tryToLocalDate 一行搞定：
// 傳了日期時(shí)間字符串，但只需要日期 → 自動(dòng)截取日期部分
DateParserUtils.tryToLocalDate("2024-01-15 14:30:45");
// → 2024-01-15
// 傳了純?nèi)掌?，但需要日期時(shí)間 → 自動(dòng)補(bǔ)當(dāng)前時(shí)間
DateParserUtils.tryToLocalDateTime("2024-01-15");
// → 2024-01-15T14:30:45（當(dāng)前系統(tǒng)時(shí)間）
// 傳了日期時(shí)間，只需要時(shí)間部分
DateParserUtils.tryToLocalTime("2024-01-15 14:30:45");
// → 14:30:45
注意：tryTo 不是"不拋異常"——它只是在類型不匹配時(shí)做了降級(jí)嘗試。降級(jí)也失敗的話，原始異常還是會(huì)拋的。
實(shí)際開發(fā)中高頻使用的方法
時(shí)間戳自動(dòng)識(shí)別
前端有時(shí)候傳秒級(jí) 1705305045，有時(shí)候傳毫秒級(jí) 1705305045000。這個(gè)方法自動(dòng)判斷：
DateParserUtils.toLocalDateTime(1705305045L); // 秒級(jí) → 正確解析 DateParserUtils.toLocalDateTime(1705305045000L); // 毫秒級(jí) → 正確解析
大于等于 1_000_000_000_000L 當(dāng)毫秒處理，否則當(dāng)秒處理。
Date 與 LocalDateTime 互轉(zhuǎn)
// Date → LocalDateTime DateParserUtils.toLocalDateTime(new Date()); // LocalDateTime → Date DateParserUtils.toDate(LocalDateTime.now()); // LocalDate → Date DateParserUtils.toDate(LocalDate.now()); // LocalTime → Date（自動(dòng)用當(dāng)天日期組合） DateParserUtils.toDate(LocalTime.of(14, 30));
字符串 → 秒/毫秒時(shí)間戳
DateParserUtils.toTimestamp("2024-01-15 14:30:45"); // 秒
DateParserUtils.toTimestampMillis("2024-01-15 14:30:45"); // 毫秒
自定義格式解析
不走自動(dòng)識(shí)別，直接用指定格式：
DateParserUtils.toLocalDateTime("2024-01-15 14:30:45", "yyyy-MM-dd HH:mm:ss");
// 用 DateTimeFormatter
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
DateParserUtils.toLocalDateTime("2024-01-15 14:30:45", fmt);
全局注冊(cè)自定義格式
內(nèi)置的 50+ 格式覆蓋了絕大部分場(chǎng)景，但如果你們的系統(tǒng)有特殊格式（比如某些老舊系統(tǒng)用 | 分隔），可以注冊(cè)全局格式：
// 應(yīng)用啟動(dòng)時(shí)注冊(cè)一次，后續(xù)所有 DateParserUtils 調(diào)用都生效
DateParserUtils.addCustomLocalDateTimeFormats(
DateTimeFormatter.ofPattern("yyyy|MM|dd HH|mm|ss")
);
// 之后直接用
DateParserUtils.toLocalDateTime("2024|01|15 14|30|45");
// → 2024-01-15T14:30:45
自定義格式優(yōu)先級(jí)最高（代碼里最先判斷），底層用 ConcurrentHashMap.newKeySet() 存儲(chǔ)，線程安全。分別有 addCustomLocalDateTimeFormats、addCustomLocalDateFormats、addCustomLocalTimeFormats 三個(gè)方法。
DateTimeFormatter 緩存
內(nèi)部所有 DateTimeFormatter 都通過緩存獲取，預(yù)初始化了 17 種常用格式，后續(xù)調(diào)用直接命中緩存，減少 pattern 字符串的 hash 比較開銷：
public static DateTimeFormatter getFormat(String format) {
return DATE_FORMAT_CACHE.get(format, () -> DateTimeFormatter.ofPattern(format));
}
性能對(duì)比
測(cè)試環(huán)境：JMH 1.37 / JDK 25
Benchmark pan-common Hutool 5.8.44 倍數(shù)
────────────────────────────────────────────────────────────────────────────
日期解析 "2026-05-31 14:30:45" 5,076 ops/ms 566 ops/ms 9.0x
日期解析 "2026/05/31 14:30:45" 5,021 ops/ms 543 ops/ms 9.2x
日期解析 "2026年5月31日 14時(shí)30分45秒" 5,264 ops/ms 269 ops/ms 19.6x
日期解析 "20260531143045" 4,226 ops/ms 3,025 ops/ms 1.4x
不適合的場(chǎng)景
說清楚它不做的事情：
- 不處理時(shí)區(qū)偏移。核心解析用系統(tǒng)默認(rèn)時(shí)區(qū)
ZoneId.systemDefault()。多時(shí)區(qū)環(huán)境要注意。 - 純數(shù)字時(shí)間戳字符串不認(rèn)。如果前端傳
"1705305045000"字符串，toLocalDateTime(String)會(huì)當(dāng)緊湊日期格式去解析。得自己先轉(zhuǎn)成long再調(diào)用。 tryToLocalTime對(duì)純?nèi)掌谧址簧А?code>"2024-01-15" 傳進(jìn)去不會(huì)變成00:00:00，因?yàn)槿掌诮M和時(shí)間組的分隔符不重疊。
總結(jié)
DateParserUtils 的核心價(jià)值就是一件事：一個(gè)方法覆蓋 50+ 種日期格式，不用傳 pattern，自動(dòng)識(shí)別。分隔符路由的思路不復(fù)雜，但實(shí)際用起來確實(shí)省事——不用再寫那一堆 try-catch 了。
到此這篇關(guān)于一文分享Java日期解析的完整方案(覆蓋50+種格式自動(dòng)識(shí)別)的文章就介紹到這了,更多相關(guān)Java日期解析內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
在SpringBoot里自定義Spring MVC配置的三種方法
SpringBoot幫我們自動(dòng)配好了 MVC 的核心組件,但實(shí)際開發(fā)中,光用默認(rèn)配置肯定不夠今天就教你 3 種自定義 Spring MVC 配置的方法,從簡(jiǎn)單到復(fù)雜,新手也能一步步跟著做,需要的朋友可以參考下2026-03-03
這篇文章主要介紹了如何兩步解決maven依賴導(dǎo)入失敗的問題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-07-07
Java編程之多線程死鎖與線程間通信簡(jiǎn)單實(shí)現(xiàn)代碼
這篇文章主要介紹了Java編程之多線程死鎖與線程間通信簡(jiǎn)單實(shí)現(xiàn)代碼，具有一定參考價(jià)值，需要的朋友可以了解下。2017-10-10
Spring MVC打印@RequestBody、@Response日志的方法
這篇文章主要介紹了Spring MVC打印@RequestBody、@Response日志的方法，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2019-02-02
從零搭建腳手架之集成Spring?Retry實(shí)現(xiàn)失敗重試和熔斷器模式(實(shí)戰(zhàn)教程)
在我們的大多數(shù)項(xiàng)目中，會(huì)有一些場(chǎng)景需要重試操作，而不是立即失敗，讓系統(tǒng)更加健壯且不易發(fā)生故障，這篇文章主要介紹了從零搭建開發(fā)腳手架之集成Spring?Retry實(shí)現(xiàn)失敗重試和熔斷器模式,需要的朋友可以參考下2022-07-07
流程控制語句顧名思義就是控制程序走向的語句,其中包括條件語句,分支語句和循環(huán)語句,這篇文章主要給大家介紹了關(guān)于Java中控制流程語句的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),需要的朋友可以參考下2021-10-10
Eclipse如何導(dǎo)入Maven項(xiàng)目詳解（新手初學(xué)）
這篇文章主要介紹了Eclipse如何導(dǎo)入Maven項(xiàng)目詳解（新手初學(xué)），小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-12-12
SpringBoot項(xiàng)目使用協(xié)同過濾的實(shí)現(xiàn)
協(xié)同過濾是一種常用的推薦系統(tǒng)算法,用于預(yù)測(cè)用戶可能喜歡的物品,本文主要介紹了SpringBoot項(xiàng)目使用協(xié)同過濾的實(shí)現(xiàn),感興趣的可以了解一下2023-09-09
這篇文章主要介紹了spring事務(wù)異常回滾實(shí)例解析，具有一定借鑒價(jià)值,需要的朋友可以參考下2018-01-01
這篇文章主要介紹了使用idea啟動(dòng)DataX的方法示例，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-01-01