Java如何判断日期匹配周期性并计算周期累加次数？

你原有的循环累加生成时间序列的方案存在明显性能缺陷，当起始时间和目标时间间隔较大时，会生成大量不必要的时间对象、占用额外内存，最优实现可通过时间差算术计算完成，时间复杂度为O(1)，无需生成全量时间序列。

核心实现逻辑 #

• 统一将起始时间、目标时间转换为相同单位的时间戳，确保时区一致避免误差
• 将周期长度转换为与时间戳相同单位的数值
• 计算目标时间与起始时间的差值，若差值为负则说明目标时间早于起始时间，直接判定不匹配
• 用差值对周期值取模，若模为0则匹配成功，对应周期次数为差值 / 周期值，否则判定不匹配

Java 实现代码 #

import java.time.Duration;
import java.time.LocalDateTime;

public class PeriodMatcher {
    /**
     * 计算目标时间匹配周期规则的次数
     * @param startTime 周期起始时间
     * @param targetTime 待校验的目标时间
     * @param period 周期时长
     * @return 匹配返回对应的周期次数，不匹配返回-1
     */
    public static long calculateMatchTimes(LocalDateTime startTime, LocalDateTime targetTime, Duration period) {
        // 目标时间早于起始时间直接返回不匹配
        if (targetTime.isBefore(startTime)) {
            return -1;
        }
        long betweenMillis = Duration.between(startTime, targetTime).toMillis();
        long periodMillis = period.toMillis();
        // 取模判断是否符合周期规则
        if (betweenMillis % periodMillis == 0) {
            return betweenMillis / periodMillis;
        }
        return -1;
    }

    public static void main(String[] args) {
        // 示例场景测试
        LocalDateTime startTime = LocalDateTime.of(2021, 9, 13, 0, 0);
        LocalDateTime targetTime = LocalDateTime.of(2021, 9, 13, 23, 0);
        Duration period = Duration.ofHours(1);
        
        long result = calculateMatchTimes(startTime, targetTime, period);
        if (result != -1) {
            System.out.println("匹配成功，对应周期次数：" + result);
            // 输出结果为23，符合示例场景预期
        } else {
            System.out.println("目标时间不匹配周期规则");
        }
    }
}

注意事项 #

• 纯固定时间周期的场景直接使用上述算术计算即可，相比循环生成序列的方案，无论间隔多大都不会出现性能损耗
• 涉及跨时区、夏令时的业务场景，建议使用ZonedDateTime替代LocalDateTime，指定固定时区进行差值计算，避免时间偏移导致的计算错误
• 如果周期规则包含非固定时间逻辑（如仅工作日生效、排除特定日期），可在上述计算基础上增加额外的日期过滤规则即可

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