定时任务 @Scheduled cron 表达式

cron 表达式格式和各占位符解释:

{秒数} {分钟} {小时} {日期} {月份} {星期} {年份(可为空)}

{秒数} {分钟} 允许值范围: 0~59,不允许为空值,若值不合法,调度器将抛出SchedulerException异常

{小时} 允许值范围: 0~23 ,不允许为空值,若值不合法,调度器将抛出SchedulerException异常,占位符和秒数一样

{日期} 允许值范围: 1~31,不允许为空值,若值不合法,调度器将抛出 SchedulerException 异常

{星期} 允许值范围: 1~7 (SUN-SAT), 1代表星期天(一星期的第一天),以此类推,7代表星期六(一星期的最后一天),不允许为空值,若值不合法,调度器将抛出SchedulerException异常

{年份} 允许值范围: 1970~2099 ,允许为空,若值不合法,调度器将抛出SchedulerException异常

注意:除了{日期}{星期}可以使用?来实现互斥,表达无意义的信息之外,其他占位符都要具有具体的时间含义,且依赖关系为:年->月->日期(星期)->小时->分钟->秒数

引用自:@Scheduled(cron = “* * * * * *”) cron表达式详解

{Seconds} {Minutes} {Hours} {DayofMonth} {Month} {DayofWeek} {Year}

每一个域可出现的字符如下:
Seconds: 可出现”, - * /“四个字符,有效范围为0-59的整数

Minutes: 可出现”, - * /“四个字符,有效范围为0-59的整数

Hours: 可出现”, - * /“四个字符,有效范围为0-23的整数

DayofMonth :可出现”, - * / ? L W C“八个字符,有效范围为0-31的整数

Month: 可出现”, - * /“四个字符,有效范围为1-12的整数或JAN-DEC

DayofWeek: 可出现”, - * / ? L C #“字符,有效范围为1-7的整数或SUN-SAT两个范围。1表示星期天,2表示星期一, 依次类推

Year: 可出现”, - * /“四个字符,有效范围为1970-2099

每一个域都使用数字,但还可以出现如下特殊字符,它们的含义是:

(1) *:表示匹配该域的任意值,假如在Minutes域使用*, 即表示每分钟都会触发事件。

(2) ?:只能用在DayofMonth和DayofWeek两个域。它也匹配域的任意值,但实际不会。因为 DayofMonth 和 DayofWeek 会相互影响。例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ?, 其中最后一位只能用?,而不能使用*,如果使用*表示不管星期几都会触发,实际上并不是这样。

(3) -:表示范围,例如在Minutes域使用5-20,表示从5分到20分钟每分钟触发一次

(4) /:表示起始时间开始触发,然后每隔固定时间触发一次,例如在Minutes域使用5/20,则意味着5分钟触发一次,而25,45等分别触发一次

(5) ,:表示列出枚举值值。例如:在Minutes域使用5,20,则意味着在5和20分每分钟触发一次。

(6) L:表示最后,只能出现在DayofWeek和DayofMonth域,如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。

(7) W:表示有效工作日(周一到周五),只能出现在DayofMonth域,系统将在离指定日期的最近的有效工作日触发事件。例如:在 DayofMonth使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一 到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份。

(8) LW:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。

(9) #:用于确定每个月第几个星期几,只能出现在DayofMonth域。例如在4#2,表示某月的第二个星期三。

引用自:@Scheduled cron表达式

例子

cron表达式的强大魅力在于灵活的横向和纵向组合以及简单的语法,用cron表达式几乎可以写出任何你想要触发的时间点与周期

经典案例:

  • 30 * * * * ? 每半分钟触发任务

  • 30 10 * * * ? 每小时的10分30秒触发任务

  • 30 10 1 * * ? 每天1点10分30秒触发任务

  • 30 10 1 20 * ? 每月20号1点10分30秒触发任务

  • 30 10 1 20 10 ? * 每年10月20号1点10分30秒触发任务

  • 30 10 1 20 10 ? 2011 2011年10月20号1点10分30秒触发任务

  • 30 10 1 ? 10 * 2011 2011年10月每天1点10分30秒触发任务

  • 30 10 1 ? 10 SUN 2011 2011年10月每周日1点10分30秒触发任务

  • 15,30,45 * * * * ? 每15秒,30秒,45秒时触发任务

  • 15-45 * * * * ? 15到45秒内,每秒都触发任务

  • 15/5 * * * * ? 每分钟的每15秒开始触发,每隔5秒触发一次

  • 15-30/5 * * * * ? 每分钟的15秒到30秒之间开始触发,每隔5秒触发一次

  • 0 0/3 * * * ? 每小时的第0分0秒开始,每三分钟触发一次

  • 0 15 10 ? * MON-FRI 星期一到星期五的10点15分0秒触发任务

  • 0 15 10 L * ? 每个月最后一天的10点15分0秒触发任务(L 可以看出来是 Last 的缩写“最后一个”)

  • 0 15 10 LW * ? 每个月最后一个工作日的10点15分0秒触发任务(LW 可以看出来是 LastWeekday 的缩写“最后一个工作日”)

  • 0 15 10 ? * 5L 每个月最后一个星期四的10点15分0秒触发任务

  • 0 15 10 ? * 5#3 每个月第三周的星期四的10点15分0秒触发任务

发表评论