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 * * * ? 可能导致每秒钟都在执行。
