Java日期计算工具与时间类详解

本文深入解析了Java中时间计算的正确实践，强调摒弃过时且易出错的Date/Calendar方案，全面转向线程安全、语义清晰的java.time包；重点厘清Duration（精确纳秒级时长）与Period（自然年月日间隔）的适用场景与严格类型约束，警示时区转换不当、DateTimeFormatter大小写误用（如YYYY vs yyyy）、以及LocalDateTime滥用导致的8小时偏差或跨年错误等高频陷阱，并提供字符串解析、数据库时区映射、异常处理等实战要点，助你一次性避开时间计算中那些令人抓狂的“半天调试”坑。

Java里算两个时间差，别用 Date 做减法

直接用 Date.getTime() 相减看似简单，但容易忽略时区、夏令时和毫秒溢出问题。比如跨年计算或处理 LocalDateTime 时，结果可能偏差一小时甚至一天。

• 老式 Date 和 Calendar 是可变对象，多线程下不安全
• 推荐统一用 java.time 包：它不可变、线程安全、语义清晰
• 如果输入是字符串（如 "2024-03-15 14:30:00"），先用 DateTimeFormatter 解析，别硬拆字符串

用 Duration 和 Period 分清“多久”和“隔几月”

Duration 算的是精确到纳秒的时间跨度（适合毫秒/秒/分钟级计算），Period 算的是年月日层级的自然单位（适合“3个月零5天”这种业务表达）。

• 两个 Instant 或 LocalTime 之间用 Duration.between()
• 两个 LocalDate 或 LocalDateTime 之间用 Period.between()
• 混用会编译报错：Duration.between(localDate1, localDate2) 不合法

LocalDateTime start = LocalDateTime.of(2024, 3, 15, 10, 0);
LocalDateTime end = LocalDateTime.of(2024, 6, 20, 14, 30);
Period period = Period.between(start.toLocalDate(), end.toLocalDate()); // P3M5D
Duration duration = Duration.between(start, end); // PT105H30M

时区处理不当会导致结果偏移 8 小时（或其它值）

本地时间（LocalDateTime）没有时区信息，一旦涉及系统默认时区（如 Asia/Shanghai）或网络时间（UTC），必须显式转换。

• 从数据库读 timestamp with time zone，对应 Java 类型应为 OffsetDateTime 或 ZonedDateTime，不是 LocalDateTime
• 比较不同时区的时间，先统一转成 Instant 再算差值
• System.currentTimeMillis() 返回的是 UTC 毫秒数，别直接塞给 LocalDateTime.ofInstant() 而不指定时区

解析字符串日期时，DateTimeFormatter 的模式字母大小写很关键

MM 是月份，mm 是分钟；yyyy 是带世纪的年份，YYYY 是“周所属年份”（ISO week year），二者在年末年初可能不同。

• 用户输入 "2023-12-31"，用 YYYY-MM-dd 解析可能得 2024-12-31（因该日属于 2024 年第 1 周）
• 固定格式优先用预定义常量：DateTimeFormatter.ISO_LOCAL_DATE_TIME，比手写模式更可靠
• 解析失败抛 DateTimeParseException，别用 try-catch 吞掉异常后返回 null——要明确告诉用户哪部分格式不对

终于介绍完啦！小伙伴们，这篇关于《Java日期计算工具与时间类详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！