Quartz(一):Cron表达式

时间:2023-07-12 12:23:38

正文

1. 表达式介绍

Cron:cron表达式用于配置cronTrigger的实例。cron表达式实际上是由七个子表达式组成。这些表达式之间用空格分隔。

Cron格式:[秒] [分] [小时] [日] [月] [周] [年](可选)

字段名 允许的值 允许的特殊字符
0-59  , - * /
0-59  , - * /
小时 0-59  , - * /
1-31  , - * ? / L W C
1-12 OR JAN-DEC , - * /
1-7 or SUN-SAT  , - * ? / L C #
年(可选字段) empty 1970-2099 , - * /

字符含义:

:代表所有可能的值。因此,“*”在Month中表示每个月,在Day-of-Month中表示每天,在Hours表示每小时

:表示指定范围。

:表示列出枚举值。例如:在Minutes子表达式中,“5,20”表示在5分钟和20分钟触发。

:被用于指定增量。例如:在Minutes子表达式中,“0/15”表示从0分钟开始,每15分钟执行一次。"3/20"表示从第三分钟开始,每20分钟执行一次。和"3,23,43"(表示第3,23,43分钟触发)的含义一样。

:用在Day-of-Month和Day-of-Week中,指“没有具体的值”。当两个子表达式其中一个被指定了值以后,为了避免冲突,需要将另外一个的值设为“?”。例如:想在每月20日触发调度,不管20号是星期几,只能用如下写法:0 0 0 20 * ?,其中最后以为只能用“?”,而不能用“*”。

L :用在day-of-month和day-of-week字串中。它是单词“last”的缩写。它在两个子表达式中的含义是不同的。

  在day-of-month中,“L”表示一个月的最后一天,一月31号,3月30号。

  在day-of-week中,“L”表示一个星期的最后一天,也就是“7”或者“SAT”

  如果“L”前有具体内容,它就有其他的含义了。例如:“6L”表示这个月的倒数第六天。“FRIL”表示这个月的最后一个星期五。

  注意:在使用“L”参数时,不要指定列表或者范围,这样会出现问题。

W :“Weekday”的缩写。只能用在day-of-month字段。用来描叙最接近指定天的工作日(周一到周五)。例如:在day-of-month字段用“15W”指“最接近这个月第15天的工作日”,即如果这个月第15天是周六,那么触发器将会在这个月第14天即周五触发;如果这个月第15天是周日,那么触发器将会在这个月第 16天即周一触发;如果这个月第15天是周二,那么就在触发器这天触发。注意一点:这个用法只会在当前月计算值,不会越过当前月。“W”字符仅能在 day-of-month指明一天,不能是一个范围或列表。也可以用“LW”来指定这个月的最后一个工作日,即最后一个星期五。

# :只能用在day-of-week字段。用来指定这个月的第几个周几。例:在day-of-week字段用"6#3" or "FRI#3"指这个月第3个周五(6指周五,3指第3个)。如果指定的日期不存在,触发器就不会触发。

2. 一些例子

0 * * * * ? 每1分钟触发一次
0 0 * * * ? 每天每1小时触发一次
0 0 10 * * ? 每天10点触发一次
0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发 
0 30 9 1 * ? 每月1号上午9点半
0 15 10 15 * ? 每月15日上午10:15触发

*/5 * * * * ? 每隔5秒执行一次
0 */1 * * * ? 每隔1分钟执行一次
0 0 5-15 * * ? 每天5-15点整点触发
0 0/3 * * * ? 每三分钟触发一次
0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发 
0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发
0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时
0 0 10,14,16 * * ? 每天上午10点,下午2点,4点

0 0 12 ? * WED 表示每个星期三中午12点
0 0 17 ? * TUES,THUR,SAT 每周二、四、六下午五点
0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发 
0 15 10 ? * MON-FRI 周一至周五的上午10:15触发

0 0 23 L * ? 每月最后一天23点执行一次
0 15 10 L * ? 每月最后一日的上午10:15触发 
0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发

0 15 10 * * ? 2005 2005年的每天上午10:15触发 
0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发 
0 15 10 ? * 6#3 每月的第三个星期五上午10:15触发

参考:https://www.cnblogs.com/lazyInsects/p/8075487.html

附:根据传入的时分秒等参数进行Cron表达式的生成

public static String createCronExpression(TaskScheduleModel taskScheduleModel) {
StringBuffer cronExp = new StringBuffer("");
if (null == taskScheduleModel.getJobType()) {
System.out.println("执行周期未配置");// 执行周期未配置
}
if (null != taskScheduleModel.getSecond() && null != taskScheduleModel.getMinute() && null != taskScheduleModel.getHour()) {
cronExp.append(taskScheduleModel.getSecond()).append(" ");// 秒
cronExp.append(taskScheduleModel.getMinute()).append(" ");// 分
cronExp.append(taskScheduleModel.getHour()).append(" ");// 小时
if (taskScheduleModel.getJobType().intValue() == 1) {// 每天
cronExp.append("* ");// 日
cronExp.append("* ");// 月
cronExp.append("?");// 周
} else if (taskScheduleModel.getJobType().intValue() == 3) {// 按每周
cronExp.append("? ");// 一个月中第几天
cronExp.append("* ");// 月份
Integer[] weeks = taskScheduleModel.getDayOfWeeks();// 周
for (int i = 0 ,j = weeks.length ; i < j; i++) { //月中天
if (i == j-1) {
cronExp.append(weeks[i]).append(" ");
} else {
cronExp.append(weeks[i]).append(",");
}
} } else if (taskScheduleModel.getJobType().intValue() == 2) {// 按每月
Integer[] months = taskScheduleModel.getMonthOfYear();
Integer[] days = taskScheduleModel.getDayOfMonths();// 一个月中的哪几天
for (int i = 0 ,j = days.length ; i < j; i++) { //月中天
if (i == j-1) {
cronExp.append(days[i]).append(" ");
} else {
cronExp.append(days[i]).append(",");
}
}
for (int i = 0 ,j = months.length ; i < j; i++) { //月中天
if (i == j-1) {
cronExp.append(months[i]).append(" ");
} else {
cronExp.append(months[i]).append(",");
}
}
//cronExp.append(" * ");// 月份
cronExp.append("?");// 周
} } else {
System.out.println("时或分或秒参数未配置");// 时或分或秒参数未配置
}
return cronExp.toString();
}

参数实体类字段名:省略getter和setter

    /**
* 所选作业类型: 1 -> 每天 2 -> 每月 3 -> 每周
*/
Integer jobType; /** 一周的哪几天 */
Integer[] dayOfWeeks; /** 一个月的哪几天 */
Integer[] dayOfMonths; /** 一年中的哪几个月 */
Integer[] monthOfYear; /** 秒 */
Integer second; /** 分 */
Integer minute; /** 时 */
Integer hour;