java计算下一个整5分钟时间点

需求背景

我的需求是获取当前时间之后的下一个“整5分钟时间点”。

首先，那么何为“整5分钟时间点”？
满足以下两个条件的时间：

1. 分钟数等于以下时间中的一个，且秒数和毫秒数为 0：

[00, 05, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55]

2. 获得的时间大于当前时间

然后，得到了这个“整5分钟时间点” ，我可以求得时间差：

时间差 = “整5分钟时间点” - 当前时间

最后，利用这个时间差可以用来

• 设定 缓存 的过期时间
  例如 Redis 缓存
• 设定 定时/延迟任务
  例如 ScheduledExecutorService.schedule
  例如 Timer.schedule

举例说明

例如给定时间为 2020-07-10 13:03:28 得到的“整5分钟时间”为 2020-07-10 13:05:00

实现方法

需要考虑 分钟值 为 55分钟以下 和 55分钟及以上 两种情况，代码如下：

public class TimeHelper {
    /**
     * 获取下一个分钟值以0或者5结尾的时间点（单位：毫秒）
     * @return
     */
    public static long getNextMillisEndWithMinute0or5(Date baseTime) {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(baseTime);
        int minute = calendar.get(Calendar.MINUTE);
        if (minute < 55) {
            int add = minute%10 < 5? 5 - minute%10 : 10 - minute%10;
            calendar.add(Calendar.MINUTE,add);
            calendar.set(Calendar.SECOND, 0);
            calendar.set(Calendar.MILLISECOND, 0);
            return calendar.getTime().getTime();
        }
        // 当前时间+1小时
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        calendar.set(Calendar.MILLISECOND, 0);
        Date endTime = DateUtils.addHours(calendar.getTime(), 1);
        return endTime.getTime();
    }
}

测试用例

测试用例需要用到

import org.apache.commons.lang.time.DateFormatUtils;

需要考虑到跨小时、跨天、跨（闰）月、跨（闰）年的情况，用例代码如下：

public class TimeHelperTest {

    @Test
    public void timeEndWithMinute0or5() throws ParseException {
        final String format = "yyyy-MM-dd HH:mm:ss";
        DateFormat dF = new SimpleDateFormat(format);
        long next = TimeHelper.getNextMillisEndWithMinute0or5(new Date());
        System.out.println(DateFormatUtils.format(next, format));

        long test2 = TimeHelper.getNextMillisEndWithMinute0or5(dF.parse("2020-07-10 11:35:00"));
        Assert.assertEquals("2020-07-10 11:40:00", DateFormatUtils.format(test2, "yyyy-MM-dd HH:mm:ss"));

        // 跨小时
        long test3 = TimeHelper.getNextMillisEndWithMinute0or5(dF.parse("2020-07-10 12:59:59"));
        Assert.assertEquals("2020-07-10 13:00:00", DateFormatUtils.format(test3, "yyyy-MM-dd HH:mm:ss"));

        // 跨天
        long test4 = TimeHelper.getNextMillisEndWithMinute0or5(dF.parse("2020-07-10 23:59:59"));
        Assert.assertEquals("2020-07-11 00:00:00", DateFormatUtils.format(test4, "yyyy-MM-dd HH:mm:ss"));

        // 跨闰月
        long test5 = TimeHelper.getNextMillisEndWithMinute0or5(dF.parse("2020-02-29 23:55:59"));
        Assert.assertEquals("2020-03-01 00:00:00", DateFormatUtils.format(test5, "yyyy-MM-dd HH:mm:ss"));

        // 跨闰年
        long test6 = TimeHelper.getNextMillisEndWithMinute0or5(dF.parse("2019-12-31 23:55:59"));
        Assert.assertEquals("2020-01-01 00:00:00", DateFormatUtils.format(test6, "yyyy-MM-dd HH:mm:ss"));
    }
}