本教程详细介绍了如何在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 枚举提供了多种预定义的格式风格：
- 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应用程序中高效、准确且专业地处理和格式化日期和时间。
