Cron表达式

Ref

• 详解定时任务中的 cron 表达式 | 掘金
• Spring Task中cron表达式详解
• Cron 可视化工具
• IDEA-Cron Description 插件

表达式定义

cron 表达式是一个字符串，该字符串由 6 个空格分为 7 个域，每一个域代表一个时间含义。 通常定义 “年” 的部分可以省略，实际常用的 Cron 表达式由前 6 部分组成。格式如下

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

域	是否必填	值以及范围	通配符
秒	是	0-59	, - * /
分	是	0-59	, - * /
时	是	0-23	, - * /
日	是	1-31	, - * ? / L W
月	是	1-12 或 JAN-DEC	, - * /
周	是	1-7 或 SUN-SAT	, - * ? / L #
年	否	1970-2099	, - * /

需要说明的是，Cron 表达式中，“周” 是从周日开始计算的。“周” 域上的 1 表示的是周日，7 表示周六。

Cron中的通配符

• , ：指的是在两个以上的时间点中都执行。如果我在 “分” 这个域中定义为 8,12,35，则表示分别在第8分，第12分 第35分执行该定时任务。
• - ：指定在某个域的连续范围。如果在 “时” 这个域中定义 1-6，则表示在 1 到 6 点之每小时都触发一次，等价于 1,2,3,4,5,6
• * ：表示所有值，可解读为 “每”。 如果在 “日” 这个域中设置 *，表示每一天都会触发。
• ? ：表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如，要在每月的 8 号触发一个操作，但不关心是周几，我们可以这么设置 0 0 0 8 * ?
• / ：表示触发步进(step)，"/" 前面的值代表初始值( "*" 等同 "0")，后面的值代表偏移量，在某个域上周期性触发。比如 在 “秒” 上定义 5/10 表示从 第 5 秒开始，每 10 秒执行一次；而在 “分” 上则表示从 第 5 分钟开始，每 10 分钟执行一次。
• L ：表示英文中的 LAST 的意思，只能在 “日” 和 “周” 中使用。在 “日” 中设置，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年), 在 “周” 上表示周六，相当于 “7” 或 “SAT”。如果在 “L” 前加上数字，则表示该数据的最后一个。例如在 “周” 上设置 “7L” 这样的格式，则表示 “本月最后一个周六”。
• W ：表示离指定日期的最近那个工作日(周一至周五)触发，只能在 “日” 中使用且只能用在具体的数字之后。若在 “日” 上置 “15W”，表示离每月 15 号最近的那个工作日触发。假如 15 号正好是周六，则找最近的周五(14号)触发；如果 15 号是周未，则找最近的下周一(16号)触发；如果 15 号正好在工作日(周一至周五)，则就在该天触发。如果是 “1W” 就只能往本月的下一个最近的工作日推不能跨月往上一个月推。
• #： 例如，A#B 表示每月的第 B 个周的周 A（周的计数从周日开始），只能作用于 “周” 上。例如 2#3 表示在每月的第 3 个周二，5#3 表示本月第 3 周的星期四。

注意，L 用在 “周” 这个域上，每周最后一天是周六。“周” 域上的 1 表示的是周日，7 表示周六，即每周计数是从周日开始的。

可视化工具

• IDEA-Cron Description 插件
• Cron 可视化工具

在上述可视化工具网站上，点击“反解析到UI”，可以看到定时任务最近5次运行时间，便于理解。

另外，在IDEA中，安装 Cron Description 插件也可以进行可视化语义展示，如下图所示，鼠标悬浮到Cron表达式上，即可看到可视化语义。

示例

下面给出一些示例，可根据上面的解释进行解读。

• 每天晚上12点触发任务：0 0 0 * * ?
• 每隔 1 分钟执行一次：0 */1 * * * ?
• 每月 1 号凌晨 1 点执行一次：0 0 1 1 * ?
• 每月最后一天 23 点执行一次：0 0 23 L * ?
• 每周周六凌晨 3 点实行一次：0 0 3 ? * L
• 在24分，30分执行一次：0 24,30 * * * ?