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"));
    }
}