企业官网建设流程全解析

写后端接口，日期解析是个躲不过去的坎。

前端传"2024-01-15"，Excel 导出的文件里是"2024/01/15"，财务系统对接传的是"20240115"，移动端有时候还扔一个"2024年1月15日"过来。更烦人的是，有时候同一个接口，同一个参数，上游不同调用方传不同的格式——你得一个个兼容。

网上搜 “Java 日期解析”，清一色教你这么写：

// 经典做法：写一堆 try-catchpublicstaticDateparse(StringdateStr){String[]patterns={"yyyy-MM-dd HH:mm:ss","yyyy-MM-dd","yyyy/MM/dd HH:mm:ss","yyyy/MM/dd","yyyyMMddHHmmss","yyyyMMdd",// ... 写几十个};for(Stringpattern:patterns){try{returnDateUtil.parse(dateStr,pattern);}catch(Exceptione){}}thrownewIllegalArgumentException("无法解析: "+dateStr);}

代码冗长不说，性能也有问题——解析"2024年1月15日"要先试前面 40 多个常规格式，每个都走一遍DateTimeFormatter.parse，失败、抛异常、catch 吞掉，再试下一个。

DateParserUtils换了个思路：先看字符串有什么分隔符，直接跳到对应格式组，不遍历。

引入依赖

<!-- Spring Boot 2.x --><dependency><groupId>com.gitee.apanlh</groupId><artifactId>apanlh-common</artifactId><version>2.0.6</version></dependency>

Spring Boot 3.x 项目：

<dependency><groupId>com.gitee.apanlh</groupId><artifactId>apanlh-common</artifactId><version>3.0.6</version></dependency>

JDK 8+ 可用，零强制依赖。

自动识别，不传 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// 点分隔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时30分45秒");// → 2024-01-15T10:30:45// ISO 格式（带 T 和纳秒）DateParserUtils.toLocalDateTime("2024-01-15T10:30:45.123456789");// → 2024-01-15T10:30:45.123456789

一个toLocalDateTime(String)方法不传 pattern，底层自动识别不会在无效格式上浪费时间。

纯日期、纯时间也一样

// 日期解析 —— 同样自动识别DateParserUtils.toLocalDate("2024-01-15");// 横线DateParserUtils.toLocalDate("2024/01/15");// 斜杠DateParserUtils.toLocalDate("2024.01.15");// 点DateParserUtils.toLocalDate("2024_01_15");// 下划线DateParserUtils.toLocalDate("20240115");// 紧凑DateParserUtils.toLocalDate("2024年1月15日");// 中文// 时间解析DateParserUtils.toLocalTime("10:30:45");// 冒号DateParserUtils.toLocalTime("10.30.45");// 点DateParserUtils.toLocalTime("10时30分45秒");// 中文DateParserUtils.toLocalTime("103045");// 紧凑

日期额外支持下划线分隔，时间支持冒号、点、中文、紧凑四种格式。

tryTo* 降级：类型不兼容时自动处理

实际开发经常遇到：上游传了"2024-01-15 14:30:45"，但你的业务只需要日期。用toLocalDate解析会失败，因为格式组里有时间部分。

tryToLocalDate一行搞定：

// 传了日期时间字符串，但只需要日期 → 自动截取日期部分DateParserUtils.tryToLocalDate("2024-01-15 14:30:45");// → 2024-01-15// 传了纯日期，但需要日期时间 → 自动补当前时间DateParserUtils.tryToLocalDateTime("2024-01-15");// → 2024-01-15T14:30:45（当前系统时间）// 传了日期时间，只需要时间部分DateParserUtils.tryToLocalTime("2024-01-15 14:30:45");// → 14:30:45

注意：tryTo不是"不抛异常"——它只是在类型不匹配时做了降级尝试。降级也失败的话，原始异常还是会抛的。

实际开发中高频使用的方法

时间戳自动识别

前端有时候传秒级1705305045，有时候传毫秒级1705305045000。这个方法自动判断：

DateParserUtils.toLocalDateTime(1705305045L);// 秒级 → 正确解析DateParserUtils.toLocalDateTime(1705305045000L);// 毫秒级 → 正确解析

大于等于1_000_000_000_000L当毫秒处理，否则当秒处理。

Date 与 LocalDateTime 互转

// Date → LocalDateTimeDateParserUtils.toLocalDateTime(newDate());// LocalDateTime → DateDateParserUtils.toDate(LocalDateTime.now());// LocalDate → DateDateParserUtils.toDate(LocalDate.now());// LocalTime → Date（自动用当天日期组合）DateParserUtils.toDate(LocalTime.of(14,30));

字符串 → 秒/毫秒时间戳

DateParserUtils.toTimestamp("2024-01-15 14:30:45");// 秒DateParserUtils.toTimestampMillis("2024-01-15 14:30:45");// 毫秒

自定义格式解析

不走自动识别，直接用指定格式：

DateParserUtils.toLocalDateTime("2024-01-15 14:30:45","yyyy-MM-dd HH:mm:ss");// 用 DateTimeFormatterDateTimeFormatterfmt=DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");DateParserUtils.toLocalDateTime("2024-01-15 14:30:45",fmt);

全局注册自定义格式

内置的 50+ 格式覆盖了绝大部分场景，但如果你们的系统有特殊格式（比如某些老旧系统用|分隔），可以注册全局格式：

// 应用启动时注册一次，后续所有 DateParserUtils 调用都生效DateParserUtils.addCustomLocalDateTimeFormats(DateTimeFormatter.ofPattern("yyyy|MM|dd HH|mm|ss"));// 之后直接用DateParserUtils.toLocalDateTime("2024|01|15 14|30|45");// → 2024-01-15T14:30:45

自定义格式优先级最高（代码里最先判断），底层用ConcurrentHashMap.newKeySet()存储，线程安全。分别有addCustomLocalDateTimeFormats、addCustomLocalDateFormats、addCustomLocalTimeFormats三个方法。

DateTimeFormatter 缓存

内部所有DateTimeFormatter都通过缓存获取，预初始化了 17 种常用格式，后续调用直接命中缓存，减少 pattern 字符串的 hash 比较开销：

publicstaticDateTimeFormattergetFormat(Stringformat){returnDATE_FORMAT_CACHE.get(format,()->DateTimeFormatter.ofPattern(format));}

性能对比

测试环境：JMH 1.37 / JDK 25 Benchmark pan-common Hutool 5.8.44 倍数 ──────────────────────────────────────────────────────────────────────────── 日期解析 "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时30分45秒" 5,264 ops/ms 269 ops/ms 19.6x 日期解析 "20260531143045" 4,226 ops/ms 3,025 ops/ms 1.4x

不适合的场景

说清楚它不做的事情：

• 不处理时区偏移。核心解析用系统默认时区ZoneId.systemDefault()。多时区环境要注意。
• 纯数字时间戳字符串不认。如果前端传"1705305045000"字符串，toLocalDateTime(String)会当紧凑日期格式去解析。得自己先转成long再调用。
• tryToLocalTime对纯日期字符串不生效。"2024-01-15"传进去不会变成00:00:00，因为日期组和时间组的分隔符不重叠。

总结

DateParserUtils的核心价值就是一件事：一个方法覆盖 50+ 种日期格式，不用传 pattern，自动识别。分隔符路由的思路不复杂，但实际用起来确实省事——不用再写那一堆 try-catch 了。

项目地址：https://gitee.com/apanlh/pan-common

项目文档：https://gitee.com/apanlh/pan-common/wikis/首页