java_cron表达式_打印下次执行时间验证表达式是否正确

朱雀 2024-02-18 10:30 40阅读 0赞

## java\_cron表达式\_打印下次执行时间验证表达式是否正确 ##

### 前言 ###

cron表达式不常用，基本写好了很少去修改。不过在写的过程中会遇到一个问题，就是这个表达式对不对？我们怎么去验证，测试时不能等待这个任务去执行吧！  
如果按分钟、按秒的调度还好说，等等可以。如果按日、月、周为周期的怎么等？  
下面介绍如何通过CronTrigger类打印cron表达式的下次执行时间，验证cron表达式的方法。

### 环境 ###

*  JDD 1.8

### cron表达式格式 ###

Cron 表达式是一个具有时间含义的字符串，分为 6 或 7 个域，每个域用空格分隔，一个域代表一种含义。  
Cron 有如下两种语法格式：

*  秒 分 时 日 月 周
 *  秒 分 时 日 月 周 年

### cron各域字符含义及可选值 ###

*  取值范围
    
     *  秒 \[0, 59\]
     *  分 \[0, 59\]
     *  时 \[0, 23\]
     *  日 \[1, 31\]
     *  月 \[1, 12\]
     *  周 \[1, 7\] 其中 1 表示星期一，7 表示星期日。
     *  年 留空，1970~2099
 *  特殊字符
    
     *  秒 \* , - /
     *  分 \* , - /
     *  时 \* , - /
     *  日 \* , - / ? L W C
     *  月 \* , - /
     *  周 \* , - / ? L C \#
     *  年 , - \* /
 *  特殊字符含义
    
     *  字符：\* 表示所有可能的值。如：在月份域中，\* 表示每个月；在星期域中，\* 表示星期的每一天。
     *  字符：, 表示枚举值。如：在分钟域中，5,20 表示分别在 5 分钟和 20 分钟触发一次。
     *  字符：- 表示范围 。如：在分钟域中，5-20 表示从 5 分钟到 20 分钟之间每隔一分钟触发一次。
     *  字符：/ 表示步长 。如：在分钟域中，0/15 表示从第 0 分钟开始，每 15 分钟触发一次。在分钟域中3/20表示从第 3 分钟开始，每 20 分钟触发一次。
     *  字符：? 表示不指定值，仅日期和星期域支持该字符 。如：当日期或星期域其中之一被指定了值以后，为了避免冲突，需要将另一个域的值设为?。
     *  字符：L 表示单词 Last 的首字母，即最后一天，仅日期和星期域支持该字符 。如：在日期域中，L 表示某个月的最后一天。在星期域中，L 表示一个星期的最后一天，也就是星期日（SUN）。如果在 L 前有具体的内容，例如，在星期域中的 6L，表示这个月的最后一个星期六。
     *  字符：W 表示有效工作日（周一到周五），只能出现在日期域，系统将在离指定日期最近的有效工作日触发事件。W 字符寻找当前月份中最近有效工作日，连用字符 LW 时表示为指定月份的最后一个工作日。
     *  字符：\# 表示 。如：确定每个月第几个星期几，仅星期域支持该字符。
     *  字符：C 表示 。如：这个字符依靠一个指定的“日历”。也就是说这个表达式的值依赖于相关的“日历”的计算结果，如果没有“日历”关联，则等价于所有包含的“日历”。仅日期和星期域支持该字符。

### Cron表达式示例 ###

*  0 15 10 ? \* \*
    
     *  每天上午 10:15 执行任务
 *  0 15 10 \* \* ?
    
     *  每天上午 10:15 执行任务
 *  0 0 12 \* \* ?
    
     *  每天中午 12:00 执行任务
 *  0 0 10,14,16 \* \* ?
    
     *  每天上午 10:00 点、下午 14:00 以及下午 16:00 执行任务
 *  0 0/30 9-17 \* \* ?
    
     *  每天上午 09:00 到下午 17:00 时间段内每隔半小时执行任务
 *  0 \* 14 \* \* ?
    
     *  每天下午 14:00 到下午 14:59 时间段内每隔 1 分钟执行任务
 *  0 0-5 14 \* \* ?
    
     *  每天下午 14:00 到下午 14:05 时间段内每隔 1 分钟执行任务
 *  0 0/5 14 \* \* ?
    
     *  每天下午 14:00 到下午 14:55 时间段内每隔 5 分钟执行任务
 *  0 0/5 14,18 \* \* ?
    
     *  每天下午 14:00 到下午 14:55、下午 18:00 到下午 18:55 时间段内每隔 5 分钟执行任务
 *  0 0 12 ? \* WED
    
     *  每个星期三中午 12:00 执行任务
 *  0 15 10 15 \* ?
    
     *  每月 15 日上午 10:15 执行任务
 *  0 15 10 L \* ?
    
     *  每月最后一日上午 10:15 执行任务
 *  0 15 10 ? \* 6L
    
     *  每月最后一个星期六上午 10:15 执行任务
 *  0 15 10 ? \* 6\#3
    
     *  每月第三个星期六上午 10:15 执行任务
 *  0 10,44 14 ? 3 WED
    
     *  每年 3 月的每个星期三下午 14:10 和 14:44 执行任务

### 测试方法 ###

import org.junit.Test;
    import org.springframework.scheduling.support.CronTrigger;
    import org.springframework.scheduling.support.SimpleTriggerContext;
    
    import java.time.LocalDateTime;
    import java.time.ZoneId;
    import java.time.format.DateTimeFormatter;
    import java.util.Date;
    
    public class CronTest {
    
        /*
        取值范围：
            秒   [0, 59]
            分   [0, 59]
            时   [0, 59]
            日   [1, 31]
            月   [1, 12]
            周   [1, 7]
        * */
        /** cron表达式验证，打印下次执行时间 */
        @Test
        public void nextCronTrigger(){
            String cron_s = "0/2 * * * * ? ";
            String cron_min = "0 0/2 * * * ?";
            String cron_h = "0 0 0/2 * * ?";
            String cron_d = "0 1 1 1/1 * ?";
            String cron_w = "0 1 1 * * 2";
            String cron_month = "0 1 1 1 1/1 ?";
            String cur = format(new Date());
            System.out.println("现\t"+cur);
            System.out.println("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
            printNextExeTime("秒",cron_s);
            printNextExeTime("分",cron_min);
            printNextExeTime("时",cron_h);
            printNextExeTime("日",cron_d);
            printNextExeTime("周",cron_w);
            printNextExeTime("月",cron_month);
        }
    
        /** 打印下执行时间 */
        public void printNextExeTime(String msg,String cron){
            SimpleTriggerContext cxt = new SimpleTriggerContext();
            CronTrigger cronTrigger = new CronTrigger(cron);
            Date nextTime = cronTrigger.nextExecutionTime(cxt);
            String nextTimeStr = format(nextTime);
            System.out.println(msg+"\t"+nextTimeStr+"\t"+cron);
        }
        public String format(Date date){
            ZoneId zoneId = ZoneId.systemDefault();
            LocalDateTime localDate = date.toInstant().atZone(zoneId).toLocalDateTime();
            DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            return dateTimeFormatter.format(localDate);
        }
    }

执行结果：

现	2023-11-14 14:24:01
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    秒	2023-11-14 14:24:02	0/2 * * * * ? 
    分	2023-11-14 14:26:00	0 0/2 * * * ?
    时	2023-11-14 16:00:00	0 0 0/2 * * ?
    日	2023-11-15 01:01:00	0 1 1 1/1 * ?
    周	2023-11-21 01:01:00	0 1 1 * * 2
    月	2023-12-01 01:01:00	0 1 1 1 1/1 ?
    
    Process finished with exit code 0

### 总结 ###

通过上面的测试，可以方便的查看下次执行时间，去校验cron表达式是否正确。  
需要注意的是 \* 的使用，如写成这种形式 \* \*/2 \* \* \* ? 可能导致每秒钟都在执行。