Java 时间差计算的两种常用实现方式

在 Java 开发中，处理时间差异是高频需求。无论是计算项目周期、会员有效期还是日志分析，准确的时间差计算都至关重要。虽然 Java 8 之后引入了 java.time API，但在维护旧系统或特定场景下，传统的 Calendar 和 Date 类依然广泛使用。这里分享两种经典实现方案，代码可直接运行参考。

场景一：基于当前时间的相对推算

很多时候我们需要知道 N 天后是什么时间，或者 M 周后的日期。利用 Calendar 的 set 方法可以方便地修改日期字段。

import java.util.Calendar;
import java.util.Date;

public class TimeDiffDemo {
    public static void main(String[] args) {
        // 演示增加天数
        Calendar now = Calendar.getInstance();
        System.out.println("当前时间：" + new Date());
        
        int daysToAdd = 280;
        now.set(Calendar.DATE, now.get(Calendar.DATE) + daysToAdd);
        System.out.println(daysToAdd + "天后的时间：" + now.getTime());
        
        // 演示增加周数
        Calendar nextMonth = Calendar.getInstance();
        int weeksToAdd = 37;
        nextMonth.set(Calendar.DATE, nextMonth.get(Calendar.DATE) + (weeksToAdd * 7));
        System.out.println(weeksToAdd + "周后的时间：" + nextMonth.getTime());
    }
}

这里要注意，Calendar 是基于本地时区的，如果涉及跨时区业务，建议后续迁移到 ZonedDateTime。另外，直接操作 DATE 字段在某些极端情况下（如月末）可能会自动进位，通常这正是我们想要的行为。

场景二：两个固定日期的差值计算

如果是比较两个历史时间点，比如从 2018-03-01 到 2018-03-12 到底隔了多少天、多少小时，核心思路是将时间转换为毫秒数进行减法运算。

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

public class TimeDiffDemo {
    public static void calculateTimeDifferenceBySimpleDateFormat() throws ParseException {
        SimpleDateFormat simpleFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm");
        
        // 定义起止时间
        Date fromDate = simpleFormat.parse("2018-03-01 12:00");
        Date toDate = simpleFormat.parse("2018-03-12 12:00");
        
        long fromMillis = fromDate.getTime();
        long toMillis = toDate.getTime();
        
        // 计算天数差
        int days = (int) ((toMillis - fromMillis) / (1000 * 60 * 60 * 24));
        System.out.println("两个时间之间的天数差为：" + days);
        
        // 计算小时差
        int hours = (int) ((toMillis - fromMillis) / (1000 * 60 * 60));
        System.out.println("两个时间之间的小时差为：" + hours);
        
        // 计算分钟差
        int minutes = (int) ((toMillis - fromMillis) / (1000 * 60));
        System.out.println("两个时间之间的分钟差为：" + minutes);
    }
}

注意这里使用了 HH 而不是 hh，前者代表 0-23 小时，后者代表 1-12 小时且通常需要配合 AM/PM 标识，避免解析歧义。实际运行时会发现，只要起止时间格式严格一致，毫秒相减再除以常量即可得到结果。整数除法会自动向下取整，如果需要更精确的小数，记得将除数改为浮点数。

写在最后

上述代码保留了最基础的逻辑，适合快速查阅。但作为资深工程师的建议是，新项目请优先使用 java.time 包下的 LocalDateTime 和 Duration，它们不可变且线程安全，能避免很多由 Date 和 Calendar 带来的坑。