【SpringBoot】常用注解：@Schedule

参数详解

cron

该参数接收一个cron表达式字符串，字符串以5或6个空格隔开，分开共6或7个域，每一个域代表一个含义,，其顺序和含义见对应注释说明，如下：

[秒] [分] [时] [日] [月] [周] [年]

======= 🌟 青柠来相伴，代码更简单。🌟 =======
📚 本文所有内容，我都整理在了 青柠合集 里。👇
🎯 搜索关注【青柠代码录】，即可查看所有合集文章 ~
======= 🌟 ================ 🌟 =======

其中，[年]不是必须的域，可以省略[年]，省略[年]则一共6个域。

通配符说明：
*： 所有值。 例如：在 [分] 上设置 * 则每一分钟都会触发执行。
?： 不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的1号触发执行，而不关心是星期几，所以需要 [周] 上设置为?， 具体设置为：“0 0 0 1 * ?”。
-： 区间。例如：在 [时] 上设置 “1-3” ，则1，2，3点都会触发执行。
,： 指定多个值，例如在 [周] 上设置 “MON,WED,FRI” 表示周一，周三和周五触发。
/： 用于递增触发。如在 [秒] 上设置”5/15” 表示从5秒开始，每增15秒触发(5,20,35,50)。 在 [日] 上设置’1/3’所示每月1号开始，每隔三天触发一次。
L： 最后的意思（Last）。在 [日] 字段设置上，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年[leap]), 在 [周] 上表示星期六，相当于”7”或”SAT”。如果在”L”前加上数字，则表示该数据的最后一个。例如在 [周] 上设置”6L”这样的格式，则表示“本月最后一个星期五”
W： 离指定日期的最近那个工作日(Work Day，周一至周五)。例如在[日] 上置”15W”，表示离每月15号最近的那个工作日触发。如果15号正好是周六，则找最近的周五(14号)触发, 如果15号是周未，则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五)，则就在该天触发。如果指定格式为 “1W”,它则表示每月1号往后最近的工作日触发。如果1号正是周六，则将在3号下周一触发。(注：”W”前只能设置具体的数字，不允许区间”-“)。
#： 序号(表示每月的第几个周几)，例如在 [周] 上设置”6#3”表示在每月的第三个周六，注意如果指定”#5”,正好第五周没有周六，则不会触发该配置(适用于没有固定日期的节假日：如母亲节和父亲节) 。
TIPS：
1）’L’和 ‘W’可以一组合使用。如果在 [日] 上设置”LW”，则表示在本月的最后一个工作日触发
2）周字段的设置，若使用英文字母是不区分大小写的，即MON与mon相同。
3）cron属性如注释中所说，支持${ }表达式，可从spring配置文件中动态获取配置的cron表达式：
task:
    # 每天凌晨2点执行任务
    cron: 0 0 2 * * ?
    # 任务间隔分钟数
    interval: 15
    fixed-delay: 5000
/**
  * 测试配置的 cron 表达式
  */
 @Scheduled(cron = "${task.cron}")
 public void test_1() {
     System.out.println("Task running: " + System.currentTimeMillis());
 }
 /**
  * 测试分钟配置表达式
  */
 @Scheduled(cron = "* 0/${task.interval} * * * *")
 void test_2() {
    System.out.println("Task running: " + System.currentTimeMillis());
 }

zone

时区，接收一个java.util.TimeZone#ID。cron表达式会基于该时区解析。默认是一个空字符串，即取服务器所在地的时区。比如我们一般使用的时区Asia/Shanghai。该字段我们一般留空。

fixedDelay / fixedDelayString

上一次执行完毕时间点之后多长时间再执行，long型。如：

// 上次任务执行结束后15秒再执行下一次
 @Scheduled(fixedDelay = 15000)

fixedDelayString与 fixedDelay意思相同，String类型。唯一不同是支持占位符。如：

// 上次任务执行结束后15秒再执行下一次
 @Scheduled(fixedDelayString = "15000")

占位符的使用 (上文中有配置：task.fixed-delay=15000)：

@Scheduled(fixedDelayString = "${task.fixed-delay}")
 void testFixedDelayString() {
    System.out.println("Task running: " + System.currentTimeMillis());
 }

fixedRate / fixedRateString

上一次开始执行时间点之后多长时间再执行，long型。如：

// 上次任务执行结束后15秒再执行下一次
 @Scheduled(fixedRate = 15000)

fixedRateString与 fixedRate 意思相同，String类型。唯一不同是支持占位符。

initialDelay / initialDelayString

第一次延迟多长时间后再执行，long型。如：

//  第一次延迟5秒后执行，之后按fixedRate的规则每10秒执行一次
 @Scheduled(initialDelay = 5000, fixedRate = 10000)

initialDelayString与 initialDelay 意思相同，String类型。唯一不同是支持占位符。

常见案例

@Scheduled(cron = “0 0/5 * * * ?”) 表示每5分钟执行一次，从第0分钟开始。0分钟会执行一次，5，10,15，20以此例推，就算是8点17分启动的，也会在8点20开始执行

每隔5秒执行一次："*/5 * * * * ?"

每隔1分钟执行一次：“0 */1 * * * ?”

每天23点执行一次：“0 0 23 * * ?”

每天凌晨1点执行一次：“0 0 1 * * ?”

每月1号凌晨1点执行一次：“0 0 1 1 * ?”

每月最后一天23点执行一次：“0 0 23 L * ?”

每周星期天凌晨1点实行一次：“0 0 1 ? * L”

在26分、29分、33分执行一次：“0 26,29,33 * * * ?”

每天的0点、13点、18点、21点都执行一次：“0 0 0,13,18,21 * * ?”

表示在每月的1日的凌晨2点调度任务：“0 0 2 1 * ? *”

表示周一到周五每天上午10：15执行作业：“0 15 10 ? * MON-FRI”

表示2002-2006年的每个月的最后一个星期五上午10:15执行：“0 15 10 ? 6L 2002-2006”

注意：由于"月份中的日期"和"星期中的日期"这两个元素互斥的,必须要对其中一个设置?
0 0 10,14,16 * * ? 每天上午10点，下午2点，4点

0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时

0 0 12 ? * WED 表示每个星期三中午12点

“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 * ?” 每月15日上午10: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触发
1、fixedRate配置了上一次任务的开始时间到下一次任务的开始时间的间隔，每次任务都会执行；
2、fixedDelay配置了上一次任务的结束时间到下一次任务的开始时间的间隔，每次任务都会执行；
3、cron表达式配置了在哪一刻执行任务，会在配置的任务开始时间判断任务是否可以执行，如果能则执行，不能则会跳过本次执行；
4、如果是强调任务间隔的定时任务，建议使用fixedRate和fixedDelay，如果是强调任务在某时某分某刻执行的定时任务，建议使用cron表达式。