应统一使用java.time包计算时间差:用Duration.between()处理Instant或LocalTime,Period.between()处理LocalDate或LocalDateTime;注意时区转换、单位语义区分及DateTimeFormatter大小写敏感问题。

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),二者在年末年初可能不同。
立即学习“Java免费学习笔记(深入)”;
- 用户输入
"2023-12-31",用YYYY-MM-dd解析可能得2024-12-31(因该日属于 2024 年第 1 周) - 固定格式优先用预定义常量:
DateTimeFormatter.ISO_LOCAL_DATE_TIME,比手写模式更可靠 - 解析失败抛
DateTimeParseException,别用try-catch吞掉异常后返回 null——要明确告诉用户哪部分格式不对









