Java日期时间格式化：使用 java.time API 实现自定义输出-java教程-PHP中文网

Java日期时间格式化：使用 java.time API 实现自定义输出

碧海醫心

发布： 2025-11-02 12:05:33

原创

866人浏览过

Java日期时间格式化：使用 java.time API 实现自定义输出

本教程详细介绍了如何在java中利用现代 `java.time` api 对日期和时间进行格式化，以满足如 "november 28, 2022 11:45:43 am" 这样的特定输出需求。文章强调了放弃传统 `java.util.date` 和 `simpledateformat` 的必要性，并提供了使用 `zoneddatetime` 和 `datetimeformatter` 进行时区感知和本地化格式化的专业指南及示例代码。

在Java开发中，日期和时间的处理与格式化是一个常见的需求。然而，传统的 java.util.Date 和 java.text.SimpleDateFormat 类存在诸多设计缺陷，例如线程不安全、API复杂且不直观、时区处理不当等问题。自Java 8起，引入了全新的 java.time 包（JSR-310），提供了更健壮、更易用、更清晰的日期和时间API，强烈建议所有新旧项目都优先使用 java.time。

1. 废弃传统API，拥抱 java.time

旧的 java.util.Date 类实际上是一个时间戳，不包含时区信息，而 SimpleDateFormat 在并发环境下可能导致非预期结果。为了避免这些问题，我们应该完全转向 java.time 包中的类，例如 LocalDate、LocalTime、LocalDateTime、ZonedDateTime 和 Instant 等。

2. 获取当前时刻与时区感知

在处理日期和时间时，时区是一个至关重要的概念。java.time API 提供了 ZonedDateTime 类来表示带有时区信息的日期和时间。获取当前时刻通常需要指定一个时区，以确保结果的准确性。

import java.time.ZonedDateTime;
import java.time.ZoneId;

public class DateTimeExample {
    public static void main(String[] args) {
        // 获取指定时区的当前日期和时间
        // ZoneId.of() 方法接受一个时区ID字符串，例如 "Asia/Tokyo", "America/New_York", "Europe/London"
        ZoneId targetZone = ZoneId.of("Asia/Tokyo"); // 示例：使用东京时区
        ZonedDateTime now = ZonedDateTime.now(targetZone);

        System.out.println("当前东京时间 (ZonedDateTime): " + now);
    }
}

登录后复制

在上面的例子中，ZonedDateTime.now(ZoneId) 返回了一个包含指定时区信息的当前时刻。选择合适的时区对于确保应用程序的正确行为至关重要。

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

3. 使用 DateTimeFormatter 进行格式化

DateTimeFormatter 是 java.time 包中用于日期和时间格式化的核心类。它提供了两种主要的格式化方式：基于本地化风格的格式化和基于自定义模式的格式化。

3.1 基于本地化风格的格式化

DateTimeFormatter.ofLocalizedDateTime() 方法允许我们根据 Locale（语言环境）和 FormatStyle（格式风格）自动生成本地化的日期时间字符串。这是一种推荐的做法，因为它能够自动适应不同地区的用户习惯。

FormatStyle 枚举提供了多种预定义的格式风格：

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

FULL: 最完整格式（例如：星期一, 2022年11月28日下午03时30分30秒 CST）
LONG: 较完整格式（例如：2022年11月28日下午03时30分30秒 CST）
MEDIUM: 中等格式（例如：2022-11-28 15:30:30）
SHORT: 简洁格式（例如：22-11-28 下午3:30）

结合 Locale，我们可以得到符合特定地区习惯的输出。例如，要实现类似 "November 28, 2022 11:45:43 AM" 的英文长格式输出，可以使用 FormatStyle.LONG 和 Locale.US。

import java.time.ZonedDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.Locale;

public class LocalizedFormattingExample {
    public static void main(String[] args) {
        ZoneId targetZone = ZoneId.of("Asia/Tokyo");
        ZonedDateTime now = ZonedDateTime.now(targetZone);

        // 使用Locale.US和LONG风格进行本地化格式化
        DateTimeFormatter formatter = DateTimeFormatter
                                        .ofLocalizedDateTime(FormatStyle.LONG)
                                        .withLocale(Locale.US);

        String formattedDate = now.format(formatter);
        System.out.println("本地化格式 (Locale.US, LONG): " + formattedDate);
        // 示例输出可能为: November 28, 2022 at 11:45:43 AM JST (具体取决于系统时区和Java版本)
        // 注意：输出可能包含"at"和时区缩写，这取决于Locale和FormatStyle的定义。
    }
}

登录后复制

3.2 使用自定义模式进行精确格式化

如果本地化格式无法满足精确的字符串模式要求，例如，需要严格控制输出中不包含 "at" 或时区缩写，或者需要特定的月份名称显示方式，可以使用 DateTimeFormatter.ofPattern() 方法。此方法接受一个模式字符串，类似于 SimpleDateFormat 的模式，但具有更好的行为和线程安全性。

为了实现 "November 28, 2022 11:45:43 AM" 这样的格式，我们可以使用模式字符串 "MMMM dd, yyyy hh:mm:ss a"：

MMMM: 完整的月份名称（例如：November）
dd: 月份中的日期（两位数，不足补零）
yyyy: 四位年份
hh: 12小时制的小时（两位数，不足补零）
mm: 分钟（两位数，不足补零）
ss: 秒（两位数，不足补零）
a: 上午/下午标记（AM/PM）

import java.time.ZonedDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.util.Locale; // 导入Locale以确保月份名称的语言环境

public class CustomPatternFormattingExample {
    public static void main(String[] args) {
        ZoneId targetZone = ZoneId.of("Asia/Tokyo");
        ZonedDateTime now = ZonedDateTime.now(targetZone);

        // 定义自定义模式，并指定Locale以确保月份名称的语言
        DateTimeFormatter customFormatter = DateTimeFormatter
                                            .ofPattern("MMMM dd, yyyy hh:mm:ss a")
                                            .withLocale(Locale.US); // 确保月份名称为英文

        String formattedDateCustom = now.format(customFormatter);
        System.out.println("自定义模式格式: " + formattedDateCustom);
        // 示例输出: November 28, 2022 11:45:43 AM (准确匹配要求)
    }
}

登录后复制

注意事项：

当使用 MMMM（完整月份名称）时，强烈建议通过 .withLocale() 方法指定一个 Locale，以确保月份名称以期望的语言显示。例如，Locale.US 会显示 "November"，而 Locale.CHINA 则可能显示 "十一月"。
hh 用于12小时制，HH 用于24小时制。a 标记只与12小时制 (hh) 配合使用。

4. 完整示例代码

结合上述两种格式化方法，以下是一个完整的Java程序，演示如何使用 java.time API 实现日期时间格式化：

import java.time.ZonedDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.Locale;

public class JavaDateTimeTutorial {
    public static void main(String[] args) {
        // 1. 获取当前时刻，指定时区
        // 建议使用实际目标时区，例如 "America/New_York", "Europe/Berlin" 等
        ZoneId currentZone = ZoneId.of("Asia/Shanghai"); // 示例：上海时区
        ZonedDateTime now = ZonedDateTime.now(currentZone);

        System.out.println("原始 ZonedDateTime (上海时区): " + now);

        // 2. 使用本地化风格进行格式化 (Locale.US, LONG)
        // 这种方式更推荐用于国际化应用，它会自动适应语言环境
        DateTimeFormatter localizedFormatter = DateTimeFormatter
                                                .ofLocalizedDateTime(FormatStyle.LONG)
                                                .withLocale(Locale.US);

        String localizedFormattedDate = now.format(localizedFormatter);
        System.out.println("本地化格式 (Locale.US, LONG): " + localizedFormattedDate);
        // 示例输出可能为: November 28, 2022 at 11:45:43 AM CST (具体取决于Java版本和时区)

        System.out.println("----------------------------------------");

        // 3. 使用自定义模式进行精确格式化
        // 这种方式适用于需要严格匹配特定字符串模式的场景
        DateTimeFormatter customPatternFormatter = DateTimeFormatter
                                                    .ofPattern("MMMM dd, yyyy hh:mm:ss a")
                                                    .withLocale(Locale.US); // 确保月份名称为英文

        String customFormattedDate = now.format(customPatternFormatter);
        System.out.println("自定义模式格式 (MMMM dd, yyyy hh:mm:ss a): " + customFormattedDate);
        // 示例输出: November 28, 2022 11:45:43 AM (准确匹配教程要求)

        System.out.println("----------------------------------------");

        // 4. 额外示例：其他时区的自定义格式化
        ZoneId londonZone = ZoneId.of("Europe/London");
        ZonedDateTime londonTime = ZonedDateTime.now(londonZone);
        String londonFormatted = londonTime.format(customPatternFormatter);
        System.out.println("伦敦时间 (自定义模式): " + londonFormatted);
    }
}

登录后复制

5. 总结与最佳实践

弃用旧API： 始终使用 java.time 包中的类来处理日期和时间。
时区意识： 在获取和处理日期时间时，务必考虑时区。ZonedDateTime 是处理带有时区信息时刻的首选。
本地化优先： 对于面向国际用户的应用程序，优先使用 DateTimeFormatter.ofLocalizedDateTime() 结合 Locale 进行格式化，以自动适应不同地区的日期时间显示习惯。
精确控制： 如果需要精确控制输出字符串的每一个细节，或者本地化格式无法满足要求，可以使用 DateTimeFormatter.ofPattern() 定义自定义模式。在使用月份名称（MMMM）时，记得通过 .withLocale() 指定语言环境。
模式字符： 熟悉 DateTimeFormatter 的模式字符，例如 yyyy (年), MM (月), dd (日), HH (24小时制小时), hh (12小时制小时), mm (分), ss (秒), a (AM/PM)。

通过遵循这些指南，您可以在Java应用程序中高效、准确且专业地处理和格式化日期和时间。

以上就是Java日期时间格式化：使用 java.time API 实现自定义输出的详细内容，更多请关注php中文网其它相关文章！