概述
Cron表达式通常用在定时任务中,主要用来设置定时任务的触发时间,如每天一点执行一次等,下面所说的就是Quartz中会使用到Cron表达式。
Cron表达式支持7个字段,分别是秒
、分
、时
、日
、月
、周
、年
。也就是我们常说的"年月日时分秒",只是在"年"和"月"之间多个"周"而已。其中年
是可选项,各个字段之间通过空格进行分隔,如果不加上"年"则是六项,如果加上"年"则是七项,所以很好区分是否加上了"年"。
Cron表达式所允许的值和一些特殊字符如下表所示:
名称 | 是否必须 | 允许值 | 特殊字符 |
---|---|---|---|
秒 | 是 | 0-59 | , - * / |
分 | 是 | 0-59 | , - * / |
时 | 是 | 0-23 | , - * / |
日 | 是 | 1-31 | , - * ? / L W C |
月 | 是 | 1-12或JAN-DEC | , - * / |
周 | 是 | 1-7或SUN-SAT | , - * ? / L C # |
年 | 否 | 空或1970-2099 | , - * / |
注意:
- 在
周
中1表示周日,2才表示周一,以此类推,7表示周六。 - 在cron表达式中不区分大小写,即sun和SUN等价。
Cron表达式中特殊字符的说明
*
:可用在所有字段中,表示对应时间域的每一个时刻。如在分
字段时表示"每分钟";在日
字段时表示"每天"。?
:该特殊字符只在日
和周
字段中使用,通常指定为无意义的值,相当于占位符,仅占位不发挥作用。-
:表示范围,包括起始边界和结束边界。如在时
字段使用10-12
表示从10点到12点,即10,11,12
,注意它是包括10和12的。,
表达一系列特定值。如在日
字段使用1,3,5,7,9
表示1号、3号、5号、7号、9号。注意与-
字符不同的是:-
指定范围要求是连续的;,
指定一系列值,可以是离散的,也可以是连续的,如10-12
等价于10,11,12
。/
:x/y
表示一个等步长序列,其中x为起始值,y为步长值。如在分
字段中使用0/15
则表示0,15,30,45
分;如5/15
在分
字段中表示5,20,35,50
;还可以使用*/y
等同于0/y
。L
:该字符只在日
和周
字段中使用,表示"Last"的意思。但在两个字段中又有所区别,L
在日
字段中表示这个月的最后一天,如一月的31号、非闰年二月的28号;L
在周
中单独使用则表示周六,等价于数字7
;L
在周
中不单独使用,前面还有一个数值X,则表示这个月的最后星期X-1
,如6L
表示该月的最后星期五。W
:该字符只在日
字段中使用,一般是对面日期的修饰,表示离该日期最近的工作日。如15W
表示离该月15号最近的工作日,如果该月15号是星期六,则匹配14号星期五;如果15号是星期日,则匹配16号星期一;如果15号是星期二,那结果就是星期二(即如果本身是工作日则匹配本身)。注意关联的匹配日期不能跨月,如指定1W
,如果1号是星期六,则结果匹配的是3号的星期一,而非上个月的最后那天星期五。W
只能指定单一日期,不能指定日期范围。LW
:在日
字段中LW
可以组合使用,表示当月的最后一个工作日。#
:该字符只能在周
字段中使用,表示当月第几个工作日,前后分别有着数字,格式是星期#工作日
。如6#3
表示本月的第三个星期五(其中6
表示星期五,#3
表示本月第三个);而4#5
表示本月的第五个星期三,如果当月没有第五个星期三则忽略不触发。C
:该字符只在日
和周
字段中使用,表示Calendar的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。例如5C
在日期字段中就相当于日历5日以后的第一天。1C
在星期字段中相当于星期日后的第一天。
示例
表达式 | 说明 |
---|---|
0 0 12 * * ? | 每天12点运行 |
0 15 10 ? * * | 每天10点15分运行 |
0 15 10 * * ? | 每天10点15分运行 |
0 15 10 * * ? * | 每天10点15分运行 |
0 15 10 * * ? 2008 | 在2008年的每天10点15分运行 |
0 * 14 * * ? | 每天14点到15点之间每分钟运行一次,开始于14:00,结束于14:59 |
0 0/5 14 * * ? | 每天14点到15点每5分钟运行一次,开始于14:00,结束于14:55 |
0 0/5 14,18 * * ? | 每天14点到15点每5分钟运行一次,此外每天18点到19点每5钟也运行一次 |
0 0-5 14 * * ? | 每天14:00点到14:05,每分钟运行一次 |
0 10,44 14 ? 3 WED | 3月的每周三14点10分运行一次、14点44分也运行一次 |
0 15 10 ? * MON-FRI | 每月的每周一、周二、周三、周四、周五的10点15分运行 |
0 15 10 15 * ? | 每月的15号的10点15分运行 |
0 15 10 L * ? | 每月最后一天的10点15分运行 |
0 15 10 ? * 6L | 每月最后一个星期五的10点15分运行 |
0 15 10 ? * 6L 2007-2009 | 在2007、2008、2009年的每个月的最后一个星期五的10点15分运行 |
0 15 10 ? * 6#3 | 在每月的第三个星期五的10点15分运行 |
在线Cron表达式生成器
通常我们只需要大致知道一个cron表达式所代表的意思,不需要我们手动去写,网上有在线的Cron表达式生成器帮助我们快速生成cron表达式。如:https://qqe2.com/cron
我们可以通过上面的
秒
、分钟
、小时
、日
、月份
、周(星期)
、年份
选项卡来分别设置cron表达式的七个字段的值,通过下面的单选框来设置触发时间,最后生成合适的cron表达式。