使用 spring 的 @Scheduled 注解或者 quartz 来实现定时任务,都用到 cron 表达式来控制任务的定时调度;本文主要介绍下 cron 表达式及它的使用例子。
1、cron 表达式简介
cron表达式是一个字符串,字符串分为6或7个字段:
秒 分 小时 月份中的日期 月份 星期中的日期 [年份]
各字段含义:
字段 | 允许值 | 允许的特殊字符 |
秒(Seconds) | 0~59 的整数 | , - * / |
分(Minutes) | 0~59 的整数 | , - * / |
小时(Hours) | 0~23 的整数 | , - * / |
日期(DayofMonth) | 1~31 的整数(但是你需要考虑你月的天数) | , - * ? / L W C |
月份(Month) | 1~12 的整数或者 JAN-DEC | , - * / |
星期(DayofWeek) | 1~7 的整数或者 SUN-SAT(1=SUN) | , - * ? / L C # |
年(可选)(Year) | 1970~2099 | , - * / |
cron 表达式中特殊符号的含义:
* | 表示匹配该域的任意值。如在 Minutes 域使用 '*', 即表示每分钟都会触发事件。 |
? | 只能用在 DayofMonth 和 DayofWeek 两个域,表示这个位置的值不确定。DayofMonth 和 DayofWeek 是两个相互排斥的域,需把其中一个域设为 '?'。如 1 月 10 日是星期一,如果在 DayofWeek 的位置另指定星期二,就前后冲突矛盾了。 |
- | 表示范围。如在 Minutes 域使用 '5-20',表示从 5 分到 20 分钟每分钟触发一次 |
/ | 表示起始时间开始触发,然后每隔固定时间触发一次。例如在 Minutes 域使用 '5/20',则意味着 5 分钟触发一次,而 25,45 等分别触发一次. |
, | 表示列出枚举值。例如:在 Minutes 域使用 '5,20',则意味着在 5 和 20 分别触发一次。 |
L | 表示最后,只能出现在 DayofWeek 和 DayofMonth 域。在 DayofMonth 域中表示一个月的最后一天,在 DayofWeek 域表示 7 或者 SAT,如果在 DayofWeek 域中前面加上数字,它表示一个月的最后一个星期几,例如 '6L' 就表示一个月的最后一个星期五。 |
W | 只能出现在 DayofMonth 域,用于指定日期的最近工作日(周一到周五)。例如在日期域使用 '15W',表示这个月 15 号最近的工作日;所以,如果 15 号是周六,则任务会在 14 号触发;如果 15 号是周日,则任务会在周一也就是 16 号触发。如果在日期域填写 1W,即使 1 号是周六,那么任务也只会在下周一,也就是 3 号触发,'W' 指定的最近工作日是不能够跨月的。'W' 只能配合一个单独的数值使用,不能够是一个数字段,例如 '1-15W' 是错误的。 |
LW | 'L' 和 'W' 可以在日期域中联合使用,表示在某个月最后一个工作日,即最后一个星期五。 |
# | 用于确定每个月第几个星期几,只能出现在 DayofWeek 域。例如 '4#2',表示某月的第二个星期三。 |
2、cron 表达式例子
'0 0 12 * * ?' 每天中午 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 期间的每 1 分钟触发
'0 0/5 14 * * ?' 在每天下午 2 点到下午 2:55 期间的每 5 分钟触发
'0 0/5 14,18 * * ?' 在每天下午 2 点到 2:55 期间和下午 6 点到 6:55 期间的每 5 分钟触发
'0 0-5 14 * * ?' 在每天下午 2 点到下午 2:05 期间的每 1 分钟触发
'0 10,44 14 ? 3 WED' 每年三月的星期三的下午 2:10 和 2:44 触发
'0 15 10 ? * MON-FRI' 周一至周五的上午 10:15 触发
'0 15 10 15 * ?' 每月1 5 日上午1 0:15 触发
'0 15 10 L * ?' 每月最后一日的上午 10:15 触发
'0 15 10 ? * 6L' 每月的最后一个星期五上午 10:15 触发
'0 15 10 ? * 6L 2002-2005' 2002 年至 2005 年的每月的最后一个星期五上午 10:15 触发
'0 15 10 ? * 6#3' 每月的第三个星期五上午 10:15 触发