corn 表达式简介

corn 表达式的格式由 7 部分组成, 各个部分之间用空格隔开, 其中第七个部分为可选部分. 如:

* * * * * * (*), 其中, 括起来的部分表示可选.

我们把上面被空格隔开的 7 个部分称为 7 个 “域”, 每个 “域” 代表不同的含义. 分别为:

{秒} {分} {时} {日} {月} {周} {年}, 其中, {年} 可以为空.

各个域的取值如下:

, 表示列出枚举值, 用于匹配多个指定的值:

如 秒 所在的域的值是 1,3,6 表示: 在每分钟的第 1秒, 第 3 秒, 第 6 秒触发事件.
- 匹配一个特定的范围值:

如 分 所在的域的值是 10-14 表示: 在每小时的第 10, 11, 12, 13, 14 分钟都会触发事件.
* 匹配该域的任意值:

如 时 所在的域的值是 * 表示: 每小时都会触发事件.
/ 表示间隔多久触发一次, / 左边是开始触发时间, 右边是间隔时长:

如 日 所在的域的值是 5/10 表示: 从每个月的 5 日起, 每 10 天触发一次事件. 也就是每个月的第 5, 15, 25 天触发事件.

? 匹配该域的任意值:

如 日 所在的域的值是 ? 表示: 每天都会触发事件.
L 表示 “最后 (Last)”, 表示该域的最后一个值:
- 如果 L 在 日 这个域, 表示每个月的最后一天;
- 如果 L 在 周 这个域, 表示每个月的最后一个周几; 如 6L 表示某个月的最后一个周五;
C 这个符号比较特别, 用于关联一个日历. 说实话我也没有理解 C 的具体用法, 下面摘抄一个我觉得写得相对来说比较详细的解释:

C字母只能用在日和周域上,它是calendar的缩写.它表示为基于相关的日历所计算出的值(如果有的话).如果没有关联的日历,那么它就等同于包含全部的日历.比如在日域上的4C表示这个月的第4天或之后日历中的第一天,比如在周域上的1C表示这个月的第一周或之后日历中的第一天. 这个地方的日历表示的是Quartz中的Calendar对象. 它允许用户自定义一个日历出来,使用这个你就能创建一个排除所有节假日的日历了. 假设10号是放假.那么10C在你自定义的日历上就表示的11号 .

W 表示工作日, 系统将在离指定日期的最近的工作日触发事件:
- 如 日 所在的域的值为 5W , 表示在距离某月 5 日最近的工作日触发事件:
  - 如果某月 5 日恰好是周一至周五中的某一天, 那么就在 “当月 5 日” 触发事件;
  - 如果某月 5 日是周六, 那么就在 “距离周六 (5 号) 最近的一个工作日” 触发事件, 也就是上个周五 (当月 4 号) 触发事件;
  - 如果某月 5 日是周日, 那么就在 “距离周日 (5 号) 最近的一个工作日” 触发事件, 也就是下个周一 (当月 6 号) 触发事件;
- 另外, W 的最近寻找不会跨过月份, 如:
  - 1W 表示在距离某月 1 号的最近一个工作日触发事件, 但如果当月 1 号恰好是周六, 那么此次事件不会跨到上个月执行, 只会在本月下周一执行, 也就是在当月 3 号触发事件;

严格意义上来说:
- 上面提到的 “日“ 域应该叫做 “DayOfMonth“, 即一个月中的第几天;
- 上面提到的 “周“ 域应该叫做 “DayOfWeek“, 即一周中的第几天, 取值 “1 - 7“ 分别代表 “SUN - SAT“;
* 和 ? 的区别:
- * 可以用在所有的部分中;
- ? 只能用在 “第四” 和 “第六” 部分, 即 DayOfMonth 和 DayOfWeek 两部分. 这两个域的值是互斥的, 因此需要设置一个 ? 来表明不想设置的那个字段.
  
  如: 设定每个月的 20 日触发事件, 不管 20 日到底是星期几, 则只能写作: 1 1 1 20 * ? , 其中 周 所在的域只能用 ? 而非 * , 因为* 表示不管周几都会触发事件, 与意愿相违.
Cron表达式对特殊字符的大小写不敏感, 对代表星期的缩写英文大小写也不敏感.