Java解析带小数秒和时区的日期字符串

在 Java 开发中，日期时间处理是一个常见且复杂的需求。尤其当面对包含可变精度小数秒（例如 2022-11-08 10:28:04.282551-06、2022-11-08 10:28:04.282-06 甚至 2022-11-08 10:28:04-06）以及时区偏移的字符串时，传统的 java.util.Date、java.util.Calendar 和 java.text.SimpleDateFormat 类往往力不从心，容易引发 ParseException。本文将深入探讨如何利用 Java 8 引入的 java.time 包（也称为 JSR 310 或 ThreeTen-Backport）来优雅、健壮地解决这类问题。

为什么选择 java.time API？

java.time API 是对 Java 旧版日期时间 API 的彻底改进，它提供了不可变、线程安全且设计更合理的类，如 LocalDateTime、ZonedDateTime、OffsetDateTime 和 DateTimeFormatter 等。相比于 SimpleDateFormat，java.time 的格式化器具有更好的灵活性和可读性，尤其在处理复杂模式时，DateTimeFormatterBuilder 提供了强大的定制能力。使用新 API 可以避免旧 API 中常见的线程安全问题和模糊的语义。

解析包含可变小数秒和时区偏移的日期字符串

要成功解析如 2022-11-08 10:28:04.282551-06 这样的字符串，其核心挑战在于小数秒部分的长度不固定，以及时区偏移的存在。DateTimeFormatterBuilder 是解决此问题的关键工具，它允许我们构建一个能够适应这些变化的解析器。

首先，我们定义一个 DateTimeFormatter 来处理输入的日期时间字符串。这里我们选择 OffsetDateTime 来存储解析结果，因为它能够同时捕获日期、时间和小数秒，以及与 UTC 的时区偏移量。

import java.time.OffsetDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.util.Locale;

public class DateTimeProcessor {

    /**
     * 定义一个用于解析复杂日期时间字符串的格式化器。
     * 该格式化器能够处理：
     * - 日期部分：yyyy-MM-dd (ISO_LOCAL_DATE)
     * - 时间部分：HH:mm:ss，可变小数秒 (ISO_LOCAL_TIME)
     * - 时区偏移：-HH 或 +HHmm (appendOffset)
     */
    private static final DateTimeFormatter PARSE_FORMATTER =
            new DateTimeFormatterBuilder()
                    .append(DateTimeFormatter.ISO_LOCAL_DATE) // 处理日期部分，例如 2022-11-08
                    .appendLiteral(' ') // 添加日期和时间之间的空格
                    .append(DateTimeFormatter.ISO_LOCAL_TIME) // 处理时间部分，包括可变小数秒。
                                                              // ISO_LOCAL_TIME 能够接受从无小数到最多 9 位小数秒。
                    .appendOffset("+HHmm", "+00") // 处理时区偏移，例如 -06 或 +0530。
                                                  // "+00" 作为默认偏移，如果字符串中没有偏移，则使用此值。
                    .toFormatter(Locale.ROOT