一、各域说明
字段域 | 秒 | 分 | 时 | 日 | 月 | 星期(7为周六) | 年(可选) |
取值范围 | 0-59 | 0-59 | 0-23 | 1-31 | 1-12或JAN–DEC | 1-7或SUN–SAT | 1970–2099 |
可用字符 | , - * / | , - * / | , - * / | , - * ? / L W C | , - * / | , - * ? / L C # | , - * / |
示例 | 例1 | 例2 | 例3 | 例4 | 例5 | 例6 | 例7 |
二、特殊字符说明
“,”字符:列出枚举值值。例如:0 26,29,33 * * * ?表示在26分、29分、33分执行一次。
“-”字符:指定一个值的范围。例如:0 0-5 14 * * ?表示每天从下午2点开始到2:05分结束,每1分钟执行一次
“*”字符:表示匹配该域的任意值,假如在Minutes域使用*, 即表示每分钟都会触发事件。 例如:0 * 14 * * ?表示每天从下午2点开始到2:59分结束,每1分钟执行一次
“/”字符:指定一个值的增加幅度。n/m表示从n开始,每次增加m。例如:*/5 * * * * ?表示每隔5秒执行一次
“L”字符:用在日表示一个月中的最后一天,用在周表示该周最后一个星期,也就是周日。例如:0 0 23 L * ?表示每月最后一天23点执行一次。
“W”字符:指定离给定日期最近的工作日(周一到周五)。例如:在字段月域里使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份。
“LW”字符:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。
“#”字符:表示该月第几个周X。例如:6#3表示该月第3个周五
“?”字符:表示不确定的值。只能用在“月”和“周”两个域。它也匹配域的任意值,但实际不会。因为“月”和“周”会相互影响。例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 0 0 0 20 * ?, 其中最后一位只能用?,而不能使用*,如果使用*表示不管星期几都会触发,实际上并不是这样。
“C”字符:可用于“日”和“周几”字段,它是"calendar"的缩写。它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历,那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后",“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。
三、示例
举例说明
例1:每隔5秒执行一次:*/5 * * * * ?
例2:每隔5分执行一次:0 */5 * * * ?
在26分、29分、33分执行一次:0 26,29,33 * * * ?
例3:每天半夜12点30分执行一次:0 30 0 * * ? (注意日期域为0不是24)
每天凌晨1点执行一次:0 0 1 * * ?
每天上午10:15执行一次: 0 15 10 ? * * 或 0 15 10 * * ? 或 0 15 10 * * ? *
每天中午十二点执行一次:0 0 12 * * ?
每天14点到14:59分,每1分钟执行一次:0 * 14 * * ?
每天14点到14:05分,每1分钟执行一次:0 0-5 14 * * ?
每天14点到14:55分,每5分钟执行一次:0 0/5 14 * * ?
每天14点到14:55分,和18点到18点55分,每5分钟执行一次:0 0/5 14,18 * * ?
每天18点执行一次:0 0 18 * * ?
每天18点、22点执行一次:0 0 18,22 * * ?
每天7点到23点,每整点执行一次:0 0 7-23 * * ?
每个整点执行一次:0 0 0/1 * * ?
例4:每月1号凌晨1点执行一次:0 0 1 1 * ?
例5:每月最后一天23点执行一次:0 0 23 L * ?
例6:每周星期天凌晨1点执行一次:0 0 1 ? * L
例7:2016年的每天早上10:15执行一次: 0 15 10 * * ? 2016
四、代码示例模板
/** * 一天执行一次,每天2点执行 */ @Scheduled(cron = "0 0 2 * * ?") public void execute() { 。。。 }