Java 中日期时间 API 自定义解析器怎么写

小浩姑娘_5235

小浩姑娘_5235

2026-10-27

920人浏览

原创

Java 8 的 java.time API 自定义解析核心是组合扩展标准 DateTimeFormatter,而非重写逻辑,适用于模糊日期、非标标记、多格式容错等场景;可通过 DateTimeFormatterBuilder 构建带字面量、可选字段、大小写不敏感的解析器,或封装多 pattern 容错逻辑,相对语义需预处理,TemporalQuery 仅用于极少数深度定制。

java 中日期时间 api 自定义解析器怎么写

Java 8 引入的 java.time API(如 LocalDateTime、ZonedDateTime)默认通过 DateTimeFormatter 解析字符串。自定义解析器的核心不是“重写解析逻辑”,而是**组合或扩展标准 formatter 的行为**,解决标准格式不覆盖的场景(如模糊日期、带非标准标记的字符串、多格式容错等)。

用 DateTimeFormatter.ofPattern() + 自定义符号

当需要解析含特殊占位符或非标准分隔符的字符串时,可自定义模式,并配合 DateTimeFormatterBuilder 注册替换规则:

  • 使用 DateTimeFormatterBuilder 构建 formatter,支持宽松解析(如忽略空格、允许省略前导零)
  • 用 parseCaseInsensitive() 支持大小写不敏感(如 "Jan"/"JAN")
  • 用 optionalStart() 和 optionalEnd() 处理可选字段(如带或不带秒的 ISO 格式)
  • 用 appendText() 或 appendLiteral() 显式匹配固定文本(如解析 "2024-05-20@14:30" 中的 @)

示例:解析形如 "2024/05/20@14:30:05.123" 的字符串

DateTimeFormatter custom = new DateTimeFormatterBuilder()
    .appendPattern("yyyy/MM/dd")
    .appendLiteral('@')
    .appendPattern("HH:mm:ss.SSS")
    .toFormatter();

LocalDateTime dt = LocalDateTime.parse("2024/05/20@14:30:05.123", custom);

处理多格式兼容(一个字符串多种可能)

标准 DateTimeFormatter 不支持“尝试多个 pattern”,需手动封装容错逻辑:

  • 准备一组预定义的 formatter(如 ISO_LOCAL_DATE_TIME、ofPattern("yyyy-MM-dd HH:mm")、自定义中文格式等)
  • 遍历尝试解析,捕获 DateTimeParseException,跳过失败项
  • 返回首个成功解析的结果(注意时区和类型一致性,避免混用 LocalDateTime 和 ZonedDateTime)

示例:支持两种常见格式

sc-java-to-ts-interface
sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义(interface / type)。输入:飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出:包含请求参数与响应结果的 .md 文件,含完整 JSDoc 注释。触发关键词:Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载
List<datetimeformatter> formatters = List.of(
    DateTimeFormatter.ISO_LOCAL_DATE_TIME,
    DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"),
    DateTimeFormatter.ofPattern("yyyyMMddHHmmss")
);

public static LocalDateTime parseMultiFormat(String text) {
    for (DateTimeFormatter f : formatters) {
        try {
            return LocalDateTime.parse(text, f);
        } catch (DateTimeParseException ignored) {}
    }
    throw new IllegalArgumentException("无法解析日期时间: " + text);
}</datetimeformatter>

解析含业务语义的字符串(如“今天”、“上周三”)

这类非标准表达需**先做文本预处理,再转为标准时间点**,不属于 DateTimeFormatter 职责范围:

  • 用正则或关键词匹配识别相对表达(如 "今天" → LocalDate.now(),"明天" → LocalDate.now().plusDays(1))
  • 对含“第X周”“上月”等复杂语义,建议引入轻量库(如 Time4J)或自行构建解析规则树
  • 解析后统一转为 LocalDateTime 或 ZonedDateTime,再参与后续计算

示例:“今天 14:30” → 当前日期 + 指定时间

public static LocalDateTime parseRelative(String text) {
    LocalDate today = LocalDate.now();
    if (text.startsWith("今天 ")) {
        String timePart = text.substring(3).trim();
        LocalTime time = LocalTime.parse(timePart, DateTimeFormatter.ofPattern("HH:mm"));
        return LocalDateTime.of(today, time);
    }
    // 其他规则...
    throw new IllegalArgumentException("不支持的相对表达: " + text);
}

自定义 TemporalQuery(高级:控制解析细节)

极少数场景需干预解析过程本身(如把缺失的年份默认设为当前年、自动补全两位年份为四位),可通过实现 TemporalQuery<t></t> 并结合 DateTimeFormatter.withResolverFields() 或 withResolverStyle() 配合使用:

  • 通常只需设置 ResolverStyle.STRICT / LENIENT / SMART 控制校验严格度
  • 真正需 TemporalQuery 的情况极少(如解析 “05/20” 默认补当年),更推荐在 parse 后做后处理
  • 不建议直接操作 TemporalAccessor 字段映射,易出错且可读性差

不复杂但容易忽略

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11317

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8422

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7252

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1204

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2969

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20231

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习