quartz.net 时间表达式----- Cron表达式详解

Cron表达式:就是用简单的xxoo符号按照一定的规则,就能把各种时间维度表达的淋漓尽致,然后在用来做任务调度(定时服务)的quart.net中所认知执行

一个cronExpression表达式有至少6个(也可能是7个)由空格分隔的时间元素从左至右,这些元素的定义如下: 

1.秒(0–59) 

2.分钟(0–59) 

3.小时(0–23) 

4.月份中的日期(1–31) 

5.月份(1–12或JAN–DEC) 

6.星期中的日期(1–7或SUN–SAT) 

7.年份(1970–2099) 

0 0 10,14,16 * * ? 
每天上午10点,下午2点和下午4点 

0 0,15,30,45 * 1-10 * ? 
每月前10天每隔15分钟 

30 0 0 1 1 ? 2012 
在2012年1月1日午夜过30秒时 

0 0 8-5 ? * MON-FRI 
每个工作日的工作时间 


各个时间可用值如下: 

秒 0-59 , - * / 

分 0-59 , - * / 

小时 0-23 , - * / 

日 1-31 , - * ? / L W C 

月 1-12 or JAN-DEC , - * / 

周几 1-7 or SUN-SAT , - * ? / L C # 

年 (可选字段) empty, 1970-2099 , - * / 

几个简单的cron表达式欣赏下:

1、0/20 * * * * ? note:每20秒

2、15 0/2 * * * ?            

note:每小时从0分钟开始,每2分钟的第15秒,假如当前时间是20:00:00,那么他的维度就在:20:02:5,20:04:15,20:06:15 ....

3、0 0/2 17-21 * * ?          

note: 每天的下午5点到晚上9点,每隔2分中的第00秒,假如当前时间是20:24:52 ,那么他的时间维度在:20:26:00,20:28:00,20:30:00 ...

Cron表达式的符号、格式表格

表1、cron表达式特殊字符意义示意表

特殊字符

意义

*

匹配所有的值。如:*在分钟的字段域里表示 每分钟

?

只在日期域和星期域中使用。它被用来指定“非明确的值”

-

指定一个范围。如:“10-12”在小时域意味着“10点、11点、12点”

,

指定几个可选值。如:“MON,WED,FRI”在星期域里表示“星期一、星期三、星期五”

/

指定增量。如:“0/15”在秒域意思是没分钟的0,15,30和45秒。“5/15”在分钟域表示没小时的5,20,35和50。符号“*”在“/”前面(如:*/10)等价于0在“/”前面(如:0/10)

L

表示day-of-month和day-of-week域,但在两个字段中的意思不同,例如day-of-month域中表示一个月的最后一天。如果在day-of-week域表示‘7’或者‘SAT’,如果在day-of-week域中前面加上数字,它表示一个月的最后几天,例如‘6L’就表示一个月的最后一个星期五

W

只允许日期域出现。这个字符用于指定日期的最近工作日。例如:如果你在日期域中写 “15W”,表示:这个月15号最近的工作日。所以,如果15号是周六,则任务会在14号触发。如果15好是周日,则任务会在周一也就是16号触发。如果是在日期域填写“1W”即使1号是周六,那么任务也只会在下周一,也就是3号触发,“W”字符指定的最近工作日是不能够跨月份的。字符“W”只能配合一个单独的数值使用,不能够是一个数字段,如:1-15W是错误的

LW

L和W可以在日期域中联合使用,LW表示这个月最后一周的工作日

#

只允许在星期域中出现。这个字符用于指定本月的某某天。例如:“6#3”表示本月第三周的星期五(6表示星期五,3表示第三周)。“2#1”表示本月第一周的星期一。“4#5”表示第五周的星期三

C

允许在日期域和星期域出现。这个字符依靠一个指定的“日历”。也就是说这个表达式的值依赖于相关的“日历”的计算结果,如果没有“日历”关联,则等价于所有包含的“日历”。如:日期域是“5C”表示关联“日历”中第一天,或者这个月开始的第一天的后5天。星期域是“1C”表示关联“日历”中第一天,或者星期的第一天的后1天,也就是周日的后一天(周一)

表2、 Cron 表达式特殊字符意义对应表

字段

允许值

允许的特殊字符

0-59

, - * /

0-59

, - * /

小时

0-23

, - * /

月内日期

1-31

, - * ? / L W C

1-12 或者 JAN-DEC

, - * /

周内日期

1-7 或者 SUN-SAT

, - * ? / L C #

年(可选)

留空, 1970-2099

, - * /

 

Cron表达式特殊字符详解

接下来的cron表达式,我会结合着quartz来描述。首先cron表达式是有7个域的,依次分别是:秒分时日月周年,其中年是可选类型,也就是说他如果在不设定年分的情况下是每年。

1、星号(*)

他在每个域都可以存在,包含所有合法的值,看好这里是包含所有,意思就是说在那一个域上表示这个域上的所有值,加入在月,表示1-12,也就是说是每月,都会被执行。

示例1:0**1*?   note:每月1号凌晨都会被执行。

示例2:0**?**   note:每分钟的00秒被执行。

2、问号(?)

他在cron表达式中,必定存在,有且只有一个,且他只能在日和周的域中存在,表示,不关系这个域是什么值,看好了,跟*的包含所有值不同,他是不关系是月的哪一天或是周的哪一天。如果在周域定义具体的数值,日域必须为问号(?),如果在日域定义啦具体的数值,那么周域就必须为问号(?)。为什么,因为避免含糊不清的表达方式,比如3月的第20天,刚好是第三周的第5天,那么如果在日域定义20,周域定义5这样,就双重定义,很蛋疼。cron表达式也不允许。

示例1:0 10 18 ? 3 WEB     note:每年3月的每个星期三,下午6点10分都会被触发

示例2:0 10 18 15 3 ?        note:每年三月的第15天,下午6点10分都会被触发

3、横杠(-)

他在cron表达式中,可以存在任何域,如果存在某个域,表示起止时间,他表示一个时间段。

实例1:0 10 18 1-5 * ?          note:每月的1号到5号(包含每月1号和5号,每月共计5天都会被触发),下午6点10分都会被触发

实例2:0 10-15 * ? * *          note:每小时的第10分钟到第15分钟(包含每小时的第10分钟和第15分钟,每小时共计5分钟都会被触发),都会被触发

4、逗号(,)

他在cron表达式中,可以存在任何域,如果存在某个域,表示可选值,他是个多点的概念。

实例1:10,20  *  * ? * *         note:每分钟的第10秒与第20秒都会被触发

实例2:0 10,20 * 1,2 * ?          note:每月的第1天与第2天的,每小时的第10分钟与第20分钟被触发。

5、斜划线(/)

他在cron表达式中,可以存在任何域,表示增量,是在域中设定一个起始的值,然后每隔多少时间的概念。

实例1:5/20 * * ? * *           note:每分钟的第5秒,第25秒,第45秒 都会被执行。

实例2:0 * 2/2 ? *  *          note:每天的第2小时,第4小时,第6小时,第8小时 ... 第22小时的00分00秒都会被触发。

6、井号(#)

他在cron表达式中,只能存在周这一个域,表示第几周的星期几,如果超出范围,则忽略不记。

实例1:* * * ? * 3#4            note:每月的第4个星期的周2,凌晨触发。

实例2:* * * ? * 6#2            note:每月的第2个星期的周5,凌晨触发

可用值详细分析如下: 

“*”——字符可以用于所有字段,在“分”字段中设为"*"表示"每一分钟"的含义。 

“?”——字符可以用在“日”和“周几”字段. 它用来指定 '不明确的值'. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。 

“-”——字符被用来指定一个值的范围,比如在“小时”字段中设为"10-12"表示"10点到12点"。 

“,”——字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday"。 

“/”——字符用来指定一个值的的增加幅度. 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"则表示"第5, 20, 35, 和 50". 在'/'前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说,其数值范围为0到59,对于“小时”字段来说其为0到23,
对于“日”字段来说为0到31, 而对于“月”字段来说为1到12。"/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。 


“L”——字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号(非闰年)。而在“周几”字段中, 它简单的表示"7" or "SAT",但是如果在“周几”字段中使用时跟在某个数字之后,
它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要,否则你会被结果搞糊涂的。 


“W”——可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W",意为: "离该月15号最近的工作日"。因此如果15号为周六,触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W",
而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。 


“L”和“W”可以组合用于“日”字段表示为'LW',意为"该月最后一个工作日"。 

“#”—— 字符可用于“周几”字段。该字符表示“该月第几个周×”,比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”,该月是不会触发的。 

“C”—— 字符可用于“日”和“周几”字段,它是"calendar"的缩写。 它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后",“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。 

对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。 


一些例子: 

"0 0 12 * * ?" 每天中午十二点触发 
"0 15 10 ? * *" 每天早上10:15触发 
"0 15 10 * * ?" 每天早上10:15触发 
"0 15 10 * * ? *" 每天早上10:15触发 
"0 15 10 * * ? 2005" 2005年的每天早上10:15触发 
"0 * 14 * * ?" 每天从下午2点开始到2点59分每分钟一次触发 
"0 0/5 14 * * ?" 每天从下午2点开始到2:55分结束每5分钟一次触发 
"0 0/5 14,18 * * ?" 每天的下午2点至2:55和6点至6点55分两个时间段内每5分钟一次触发 
"0 0-5 14 * * ?" 每天14:00至14:05每分钟一次触发 
"0 10,44 14 ? 3 WED" 三月的每周三的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 

猜你喜欢

转载自blog.csdn.net/zhangvalue/article/details/78865054
今日推荐