首页 > 代码库 > 从Quartz时间设置问题说起

从Quartz时间设置问题说起

      已经好久没有来写点啥了,原因有很多,不过最主要的还是自己很懒很懒,今天终于意识到问题的严重性了。所以就来了。今天的这个问题也是前不久刚刚遇到的问题。先不啰嗦,说重点了。

一、问题描述

定时任务项目发布时,报错了。错误信息具体如下:

Caused by: java.lang.UnsupportedOperationException: 
    Support for specifying both a day-of-week AND a day-of-month parameter is not implemented.

二、问题调查与定位

首先,定位到定时任务项目中配置文件里的cron表达式出错导致的。

出错的cron表达式如下:

cronExpression :“0 50 1 * * MON-FRI”   (一个只需每周一至周五才会进行执行的定时任务)

该表达式被前辈们指出是“MON-FRI”的表示方法不对,随后修改为“2-6”(1表示的是周日,故周一表示为2)。然而,这样的修改依然报错。

然后,只能在网上搜索相关类似错误信息,终于发现问题的所在:此表达式中的第四项(从左向右),即day-of-month项不能是*,而应该是? 。

故正确的cron表达式为:“0 50 1 ? * MON-FRI” 或者 “0 50 1 ? * 2-6”。

最后,按正确的修改后,错误信息消失了。

三、问题分析与反思

1. 该问题的产生主要是由于自己对于cron表达式的具体说明没有弄清楚。

所以,现在需要认真再学习一下。考虑到有前辈总结的很好,故转载其文章部分内容(原文地址:http://www.cnblogs.com/skyblue/p/3296350.html ),特在此表示感谢。具体内容如下:

cron表达式:由左至右按顺序代表的含义为 :     *      *      *        *      *      *      *  

                                                        格式:   [秒] [分] [小时] [日] [月] [周] [年] 

允许的通配符
0-59,  -  *  /
0-59,  -  *  /
小时0-23,  -  *  /
日(day-of-month)1-31,  -  *  ?  /  L  W  C
1-12 或者 JAN-DEC,  -  *  /
周(day-of-week)1-7 或者 SUN-SAT,  -  *  ?  /  L  #
年(可选)空 或者1970-2099,  -  *  /

 

 

 

 

 

 

 

通配符说明如下:

* 表示所有值。 例如:在分的字段上设置 "*", 表示每一分钟都会触发。 

? 表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作,但不关心是周几,所以需要周位置的那个字段设置为"?" ,具体设置为" 0 0 0 10 * ? " 。

- 表示区间。例如: 在小时上设置 "10-12",表示 10,11,12点都会触发。 

, 表示指定多个值。例如: 在周字段上设置 "MON,WED,FRI" 表示周一,周三和周五触发。

/ 用于递增触发。例如: 在秒上面设置"5/15" 表示从5秒开始,每增15秒触发(5,20,35,50)。在月字段上设置"1/3"所示每月1号开始,每隔三天触发一次。 

L 表示最后的意思(Last)。例如: 在日字段上设置,表示当月的最后一天(依据当前月份,如果是二月还会依据是否是润年[leap])。 在周字段上表示星期六,相当于"7"或"SAT"。如果在"L"前加上数字,则表示该数据的最后一个。例如: 在周字段上设置"6L"这样的格式,则表示“本月最后一个星期五"。 

W 表示离指定日期的最近那个工作日(周一至周五)。 例如: 在日字段上设置"15W",表示离每月15号最近的那个工作日触发。如果15号正好是周六,则找最近的周五(14号)触发, 如果15号是周未,则找最近的下周一(16号)触发。如果15号正好在工作日(周一至周五),则就在该天触发。如果指定格式为 "1W",则表示每月1号往后最近的工作日触发。如果1号正是周六,则将在3号下周一触发。(注,"W"前只能设置具体的数字,不允许区间"-")。

小提示  : ‘L‘和 ‘W‘可以组合使用。如果在日字段上设置"LW",则表示在本月的最后一个工作日触发(一般指发工资 ) 。

# 序号(表示每月的第几个周几),例如在周字段上设置"6#3"表示在每月的第三个周六。注意,如果指定"#5",正好第五周没有周六,则不会触发该配置(用于母亲节和父亲节再合适不过了)。

小提示 周字段的设置,若使用英文字母是不区分大小写的 MON 与mon相同 

 

2. 从问题的调查过程可以看到:问题的定位实际上是不准确的,并没有按照错误信息进行问题的分析。所以,今后需要认真对待错误信息,以期快速准确定位问题产生的原因。

 

好了,到此本次的问题算是基本讲完了。希望工作中同样的问题不要再发生了。加油!

从Quartz时间设置问题说起