Calendar日期差计算异常：同周同日结束早于开始时结果错误问询

嘿，这个场景我太熟悉了！你遇到的核心问题是：直接用毫秒数相减的逻辑只会计算两个时间点的绝对时间差，但业务上要求当同周同一天的结束时间早于开始时间时，要默认算作一整周（7天）的间隔，而不是反过来的小时数或者负数差值。

问题根源 #

你当前的计算逻辑大概是这样的：

long t1 = curCal.getTimeInMillis();
long t2 = endCal.getTimeInMillis();
long diff = t2 - t1;
// 然后把diff转成天、小时、分钟

但当endCal的当天时间早于curCal时，diff会是负数（或者你取了绝对值），导致算出0天5小时，而不是业务需要的7天。

解决方案步骤 #

我们需要先判断两个日期是否属于同周的同一天，再根据时间先后决定是否补上一周的时长：

1. 判断同周同一天：
   • 用Calendar.get(Calendar.DAY_OF_WEEK)确认两天是同一个星期几
   • 用Calendar.get(Calendar.YEAR) + Calendar.get(Calendar.WEEK_OF_YEAR)确保是同一年的同一周（跨年周的情况可以额外用YEAR_WOY判断）
2. 判断当天时间先后：
   • 把两个Calendar的日期部分统一成固定值（比如1970年1月1日），只保留时分秒，再比较毫秒数大小
3. 调整差值：如果满足同周同一天且结束时间更早，就给总差值加上7天的毫秒数（7 * 24 * 60 * 60 * 1000L）

完整代码示例 #

import java.util.Calendar;

public class DateDiffCalculator {
    public static void calculateDiff(Calendar startCal, Calendar endCal) {
        // 获取两个时间的原始毫秒数
        long startMillis = startCal.getTimeInMillis();
        long endMillis = endCal.getTimeInMillis();
        
        // 判断是否为同周同一天
        boolean sameWeekDay = startCal.get(Calendar.DAY_OF_WEEK) == endCal.get(Calendar.DAY_OF_WEEK);
        boolean sameWeek = startCal.get(Calendar.YEAR) == endCal.get(Calendar.YEAR) 
                && startCal.get(Calendar.WEEK_OF_YEAR) == endCal.get(Calendar.WEEK_OF_YEAR);
        
        long totalDiff = endMillis - startMillis;
        
        // 满足条件则补上一周时长
        if (sameWeek && sameWeekDay) {
            // 克隆对象并重置日期，只保留当天时间
            Calendar startTimeOnly = (Calendar) startCal.clone();
            startTimeOnly.set(Calendar.YEAR, 1970);
            startTimeOnly.set(Calendar.MONTH, Calendar.JANUARY);
            startTimeOnly.set(Calendar.DATE, 1);
            
            Calendar endTimeOnly = (Calendar) endCal.clone();
            endTimeOnly.set(Calendar.YEAR, 1970);
            endTimeOnly.set(Calendar.MONTH, Calendar.JANUARY);
            endTimeOnly.set(Calendar.DATE, 1);
            
            if (endTimeOnly.getTimeInMillis() < startTimeOnly.getTimeInMillis()) {
                totalDiff += 7 * 24 * 60 * 60 * 1000L;
            }
        }
        
        // 转换为天、小时、分钟
        long days = totalDiff / (24 * 60 * 60 * 1000L);
        long remaining = totalDiff % (24 * 60 * 60 * 1000L);
        long hours = remaining / (60 * 60 * 1000L);
        remaining %= (60 * 60 * 1000L);
        long minutes = remaining / (60 * 1000L);
        
        System.out.printf("差值：%d天 %d小时 %d分钟%n", days, hours, minutes);
    }

    public static void main(String[] args) {
        // 测试场景：开始时间周六19:20，结束时间周六14:20
        Calendar startCal = Calendar.getInstance();
        startCal.set(Calendar.DAY_OF_WEEK, Calendar.SATURDAY);
        startCal.set(Calendar.HOUR_OF_DAY, 19);
        startCal.set(Calendar.MINUTE, 20);
        startCal.set(Calendar.SECOND, 0);
        
        Calendar endCal = (Calendar) startCal.clone();
        endCal.set(Calendar.HOUR_OF_DAY, 14);
        endCal.set(Calendar.MINUTE, 20);
        
        calculateDiff(startCal, endCal); // 输出：差值：7天 0小时 0分钟
    }
}

额外注意点 #

• 不同地区的周起始日可能不同（比如美国以周日为一周第一天，欧洲以周一为第一天），如果业务有特定要求，可以用Calendar.setFirstDayOfWeek()调整，避免同周判断出错。
• 若要处理跨年周（比如12月31日和1月1日属于同一周），可以用Calendar.get(Calendar.YEAR_WOY)（周所属的年份）替代YEAR来判断同周。

内容的提问来源于stack exchange，提问作者user7367398