java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > Java8日期时间API使用

Java8中日期时间API的避坑指南与最佳实践指南

作者：无心水

在Java 8之前,处理日期时间我们常用Date、Calendar和SimpleDateFormat,本文将通过实际案例,剖析老API的典型陷阱,并展示如何使用新API优雅避坑,希望对大家有所帮助

在Java 8之前，处理日期时间我们常用Date、Calendar和SimpleDateFormat。这些API虽然功能完备，但设计上存在诸多痛点：可读性差、API混乱、线程不安全、时区处理困难，稍有不慎就会掉进各种“时间错乱”的坑里。

Java 8推出了全新的日期时间API（java.time包），每个类职责清晰、操作简洁、线程安全，并且完美支持时区处理。遗憾的是，由于早期第三方库对新类型支持不足，许多项目仍在使用老API。如今几乎所有主流框架都已适配，是时候全面拥抱Java 8日期时间类了。

本文将通过实际案例，剖析老API的典型陷阱，并展示如何使用新API优雅避坑。同时，我们用Mermaid图直观呈现核心概念，帮助你彻底掌握正确的日期时间处理方式。

1. 日期时间初始化：从“穿越”到“精准”

先看一个新手常犯的错误——用Date构造函数初始化时间：

Date date = new Date(2019, 12, 31, 11, 12, 13);
System.out.println(date);

输出结果令人大跌眼镜：

Sat Jan 31 11:12:13 CST 3920

原来Date的年份参数需要减去1900，月份从0开始（0代表1月）。正确的写法是：

Date date = new Date(2019 - 1900, 11, 31, 11, 12, 13);

但这还不够，当涉及国际化时，必须使用Calendar并指定时区：

Calendar calendar = Calendar.getInstance();
calendar.set(2019, Calendar.DECEMBER, 31, 11, 12, 13);
System.out.println(calendar.getTime()); // Tue Dec 31 11:12:13 CST 2019

Calendar calendarNY = Calendar.getInstance(TimeZone.getTimeZone("America/New_York"));
calendarNY.set(2019, Calendar.DECEMBER, 31, 11, 12, 13);
System.out.println(calendarNY.getTime()); // Wed Jan 01 00:12:13 CST 2020

为什么纽约时区初始化后，输出变成了2020年1月1日？这正是时区在背后起作用。我们接着深入时区问题。

2. 时区问题：UTC才是真正的“世界时间”

2.1 Date的本质：UTC时间戳

Date内部保存的是一个long型时间戳，即从1970-01-01 00:00:00 UTC到现在的毫秒数。因此，无论你在世界哪个角落执行new Date()，得到的时间戳都是一样的。调用toString()时会根据当前JVM默认时区转换为本地时间显示，但Date本身不包含任何时区信息。

2.2 正确保存与展示时间

为了正确国际化，保存时间应当使用UTC（时间戳），展示时再根据用户时区转换为本地时间。老API中通常使用Calendar携带时区，但操作繁琐且易错。

Java 8引入了ZonedDateTime = LocalDateTime + ZoneId，彻底分离了“本地日期时间表示”和“带时区的时间点”。下面是一个完整的解析和展示示例：

String stringDate = "2020-01-02 22:00:00";
ZoneId zoneSH = ZoneId.of("Asia/Shanghai");
ZoneId zoneNY = ZoneId.of("America/New_York");
ZoneId zoneJST = ZoneOffset.ofHours(9);

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
ZonedDateTime date = ZonedDateTime.of(LocalDateTime.parse(stringDate, formatter), zoneJST);

DateTimeFormatter outputFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss Z");
System.out.println(zoneSH.getId() + outputFormatter.withZone(zoneSH).format(date));
System.out.println(zoneNY.getId() + outputFormatter.withZone(zoneNY).format(date));
System.out.println(zoneJST.getId() + outputFormatter.withZone(zoneJST).format(date));

输出：

Asia/Shanghai2020-01-02 21:00:00 +0800
America/New_York2020-01-02 08:00:00 -0500
+09:002020-01-02 22:00:00 +0900

可以看到，同一个UTC时间点（东京时区22:00）在不同时区下展示为不同的本地时间。这正是时区的正确作用，而非“时间错乱”。

2.3 时区转换流程

下面的Mermaid图清晰地展示了从本地时间表示到UTC存储，再到展示的过程：

3. 格式化和解析：三个深坑与解决方案

3.1 坑一：YYYY与yyyy傻傻分不清

Calendar cal = Calendar.getInstance();
cal.set(2019, Calendar.DECEMBER, 29);
SimpleDateFormat sdf = new SimpleDateFormat("YYYY-MM-dd");
System.out.println(sdf.format(cal.getTime())); // 2020-12-29

输出居然是2020年！原因是大写Y表示“week year”（周所在的年份），而2019年12月29日属于2020年的第一周（取决于区域设置）。下图展示了week year的计算规则：

解决方案：无特殊需求，一律使用小写y表示年份。

3.2 坑二：SimpleDateFormat线程不安全

将SimpleDateFormat定义为static并在多线程中复用，会导致解析结果混乱甚至异常：

private static SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

// 线程池中并发调用sdf.parse()

问题根源在于SimpleDateFormat内部共享Calendar实例，且操作未加锁：

public class SimpleDateFormat extends DateFormat {
    protected Calendar calendar;  // 共享变量！
    // parse方法会清空并重建calendar
}

并发时序可能导致一个线程清空Calendar后，另一个线程接着使用，产生错误结果。

解决方案：

3.3 坑三：宽松解析导致数据错误

String dateString = "20160901";
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMM");
System.out.println(sdf.parse(dateString)); // Mon Jan 01 00:00:00 CST 2091

本意是解析年月，却因为字符串包含日，被错误解析为第75个月（0901个月），得到2091年1月。

而DateTimeFormatter默认严格解析，遇到不匹配直接抛出异常：

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyyMM");
dtf.parse("20160901"); // 抛出DateTimeParseException

4. 日期时间计算：告别溢出与繁琐

4.1 时间戳计算的溢出问题

Date today = new Date();
Date nextMonth = new Date(today.getTime() + 30 * 1000 * 60 * 60 * 24);
System.out.println(nextMonth); // 比今天还早！

原因：30 * 1000 * 60 * 60 * 24 在int范围内溢出，结果为负值。改为30L即可。

手动计算时间戳容易出错，推荐使用Calendar或Java 8 API。

4.2 Java 8计算API的强大

LocalDateTime now = LocalDateTime.now();
LocalDateTime later = now.plusDays(30);  // 简洁明了

除了简单的加减，TemporalAdjusters提供了丰富的调整器：

// 本月第一天
LocalDate.now().with(TemporalAdjusters.firstDayOfMonth());

// 下一个周六
LocalDate.now().with(TemporalAdjusters.next(DayOfWeek.SATURDAY));

// 自定义：增加随机天数
LocalDate.now().with(temporal -> temporal.plus(ThreadLocalRandom.current().nextInt(100), ChronoUnit.DAYS));

4.3 Period与ChronoUnit的陷阱

计算两个日期差时，Period返回的是“几年几月几日”，而不是总天数：

LocalDate start = LocalDate.of(2019, 10, 1);
LocalDate end = LocalDate.of(2019, 12, 12);
Period period = Period.between(start, end);
System.out.println(period.getDays());   // 11（只输出剩余天数）
System.out.println(period);             // P2M11D
System.out.println(ChronoUnit.DAYS.between(start, end)); // 72（总天数）

如果需要总天数，请使用ChronoUnit.DAYS.between()。

5. 新老API转换：必须明确时区

老项目升级时难免需要互转。转换时务必提供时区，否则可能丢失信息。

// Date -> LocalDateTime
Date date = new Date();
LocalDateTime ldt = LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());

// LocalDateTime -> Date
LocalDateTime now = LocalDateTime.now();
Date out = Date.from(now.atZone(ZoneId.systemDefault()).toInstant());

下图总结了Java 8时间类与遗留类的对应关系：

6. 总结：全面拥抱Java 8日期时间API

通过以上对比，我们可以看到Java 8的java.time包在各个方面都优于旧API：

如果你还在使用Date和Calendar，是时候重构了。迁移到Java 8日期时间API，不仅能消除潜在bug，还能让代码更简洁易读。

思考与讨论：

到此这篇关于Java8中日期时间API的避坑指南与最佳实践指南的文章就介绍到这了,更多相关Java8日期时间API使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文