使用Java 8 java.time API进行日期时间字符串的转换与格式化-java教程-PHP中文网

使用Java 8 java.time API进行日期时间字符串的转换与格式化

碧海醫心

发布： 2025-11-04 16:35:01

原创

594人浏览过

使用Java 8 java.time API进行日期时间字符串的转换与格式化

本文详细介绍了如何利用java 8的`java.time` api实现日期时间字符串在不同格式间的转换，并重点阐述了时区处理的重要性。通过`datetimeformatter`定义输入输出模式，结合`zoneddatetime`进行时区感知解析与格式化，确保日期时间处理的准确性和灵活性，避免了传统api的诸多陷阱。

在现代Java应用开发中，日期时间处理是一个常见而关键的任务。尤其是在与数据库或外部系统交互时，我们经常需要将特定格式的日期时间字符串解析为Java对象，或将Java日期时间对象格式化为指定的字符串格式。Java 8引入的java.time包提供了一套强大、易用且线程安全的API，彻底改变了日期时间处理的方式。

1. 理解日期时间格式与DateTimeFormatter

java.time API的核心之一是DateTimeFormatter，它用于定义日期时间字符串的解析和格式化模式。每个模式字符都代表日期时间的一个特定组成部分（例如年份、月份、日期、小时、分钟、秒、毫秒、时区等）。

常见的模式字符示例：

yyyy: 四位年份 (e.g., 2022)
MM: 两位月份 (e.g., 11)
dd: 两位日期 (e.g., 28)
HH: 24小时制的小时 (e.g., 23)
mm: 分钟 (e.g., 36)
ss: 秒 (e.g., 43)
SSS: 毫秒 (e.g., 712)
EEE: 星期几的缩写 (e.g., Mon)
MMM: 月份的缩写 (e.g., Nov)
zzz: 时区名称缩写 (e.g., IST)

2. 解析输入日期时间字符串

假设我们从PostgreSQL数据库接收到一个日期时间字符串，格式为 2022-11-28 23:36:43.712。为了将其转换为Java中的日期时间对象，并考虑时区，我们应使用ZonedDateTime。

立即学习“Java免费学习笔记（深入）”；

首先，我们需要创建一个DateTimeFormatter来匹配输入字符串的格式：

import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;

public class DateTimeConverter {

    public static void main(String[] args) {
        String inputDateTimeString = "2022-11-28 23:36:43.712";

        // 定义输入字符串的格式
        DateTimeFormatter formatterIn = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS");

        // 解析字符串为 ZonedDateTime。
        // 关键点在于指定输入字符串所代表的时区。
        // 如果数据库时间是UTC时间，或者我们希望将其视为UTC时间，则使用 ZoneId.of("UTC")。
        // 如果输入时间没有明确的时区信息，但我们知道它属于某个特定时区，也应在此处指定。
        ZonedDateTime yourDate = ZonedDateTime.parse(inputDateTimeString, formatterIn.withZone(ZoneId.of("UTC")));

        System.out.println("解析后的 ZonedDateTime (UTC): " + yourDate);
    }
}

登录后复制

在上述代码中，formatterIn.withZone(ZoneId.of("UTC")) 这一步至关重要。它告诉解析器，尽管输入字符串本身不包含时区信息，但我们应将其解析为UTC时区的日期时间。如果这个时间实际上是另一个时区（例如，数据库服务器所在的时区），则应相应地更改 ZoneId.of() 参数。

吉卜力风格图片在线生成

将图片转换为吉卜力艺术风格的作品

121

查看详情

3. 格式化为目标日期时间字符串

接下来，我们将解析后的 ZonedDateTime 对象格式化为目标格式：Mon Nov 28 20:51:58 IST 2022。这个目标格式包含时区缩写（IST），这意味着我们需要一个时区感知的格式化器。

import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;

public class DateTimeConverter {

    public static void main(String[] args) {
        String inputDateTimeString = "2022-11-28 23:36:43.712";

        // 定义输入字符串的格式
        DateTimeFormatter formatterIn = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS");

        // 解析字符串为 ZonedDateTime，并指定输入时间为UTC
        ZonedDateTime yourDate = ZonedDateTime.parse(inputDateTimeString, formatterIn.withZone(ZoneId.of("UTC")));

        // 定义输出字符串的格式
        // 注意 "zzz" 用于表示时区名称的缩写
        DateTimeFormatter formatterOut = DateTimeFormatter.ofPattern("EEE MMM dd HH:mm:ss zzz yyyy");

        // 格式化 ZonedDateTime 对象
        // 在格式化时，ZonedDateTime 会根据其内部的时区信息进行调整并输出
        String yourDateFormatted = formatterOut.format(yourDate);

        System.out.println("格式化后的日期时间字符串: " + yourDateFormatted);
    }
}

登录后复制

运行上述代码，你会看到类似格式化后的日期时间字符串: Tue Nov 29 05:06:43 UTC 2022 的输出。请注意，这里的时区显示为 UTC，因为 yourDate 对象内部的时区是 UTC。如果目标是 IST，我们需要将 yourDate 转换到 IST 时区。

4. 处理时区转换

如果目标格式要求显示特定时区（例如 IST），则需要在格式化之前将 ZonedDateTime 对象转换到目标时区。印度标准时间（IST）对应的 ZoneId 是 Asia/Calcutta 或 Asia/Kolkata。

import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;

public class DateTimeConverter {

    public static void main(String[] args) {
        String inputDateTimeString = "2022-11-28 23:36:43.712";

        // 定义输入字符串的格式
        DateTimeFormatter formatterIn = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS");

        // 解析字符串为 ZonedDateTime，指定输入时间为UTC
        ZonedDateTime yourDateInUTC = ZonedDateTime.parse(inputDateTimeString, formatterIn.withZone(ZoneId.of("UTC")));

        // 将 ZonedDateTime 转换到目标时区 (例如，印度标准时间 IST)
        ZoneId targetZone = ZoneId.of("Asia/Calcutta"); // 或者 "Asia/Kolkata"
        ZonedDateTime yourDateInTargetZone = yourDateInUTC.withZoneSameInstant(targetZone);

        // 定义输出字符串的格式
        DateTimeFormatter formatterOut = DateTimeFormatter.ofPattern("EEE MMM dd HH:mm:ss zzz yyyy");

        // 格式化转换后的 ZonedDateTime
        String yourDateFormatted = formatterOut.format(yourDateInTargetZone);

        System.out.println("原始 UTC 时间: " + yourDateInUTC);
        System.out.println("转换到 " + targetZone.getId() + " 的时间: " + yourDateInTargetZone);
        System.out.println("格式化后的日期时间字符串 (IST): " + yourDateFormatted);
    }
}

登录后复制

运行这段代码，你会看到 yourDateFormatted 变量现在包含了 IST 时区的时间信息，例如 Tue Nov 29 05:06:43 IST 2022（具体时间取决于输入时间和时区偏移）。这展示了 ZonedDateTime 在处理跨时区日期时间时的强大功能。

5. 注意事项与最佳实践

时区的重要性： 始终明确你正在处理的日期时间是哪个时区的。如果输入字符串不包含时区信息，你需要根据上下文（例如，数据库服务器时区、应用程序默认时区）来指定一个 ZoneId 进行解析。
java.time vs. java.util.Date： 强烈建议在Java 8及更高版本中使用 java.time 包，而不是 java.util.Date 和 java.text.SimpleDateFormat。java.time API是不可变的、线程安全的，并且提供了更清晰、更强大的日期时间模型。
withZoneSameInstant() vs. atZone()：
- withZoneSameInstant(ZoneId zone): 改变日期时间对象的时区，但保持瞬间点不变。这意味着日期和时间字段会根据新的时区进行调整。这是进行时区转换的常用方法。
- atZone(ZoneId zone): 将一个 LocalDateTime（没有时区信息）附加一个时区，形成一个 ZonedDateTime。它不会改变日期和时间字段，只是赋予它一个时区上下文。
异常处理： 在实际应用中，解析日期时间字符串时应考虑 DateTimeParseException。如果输入字符串与 DateTimeFormatter 定义的模式不匹配，就会抛出此异常。

try {
    ZonedDateTime yourDate = ZonedDateTime.parse(inputDateTimeString, formatterIn.withZone(ZoneId.of("UTC")));
    // ... 后续处理
} catch (java.time.format.DateTimeParseException e) {
    System.err.println("日期时间解析失败: " + e.getMessage());
    // 处理解析错误，例如记录日志或返回错误信息
}

登录后复制