定时器 Quartz cron

Quartz cron 语法

 

最近项目上用到 Spring 的定时器调用。所以遇到这个问题，索性干脆整理下，免得每次去

网上查。最主要的原因还是因为 google 总被和谐，嘿嘿。

 

1. Quartz cron 表达式 、Unix cron 表达式的相同与区别。

    a) 级别细度差异

        Quartz 的格式向下支持到秒级别的计划，而 Unix cron 计划仅支持至分钟级。

        许多我们的触发计划要基于秒级递增的，例如：每 45 秒。

    b) 命令存放差异

        在 Unix cron 里，要执行的作业（或者说命令）是存放在 cron 表达式中的，

        在第六个域位置上。Quartz 用 cron 表达式存放执行计划。

        引用了 cron 表达式的CronTrigger 在计划的时间里会与 Job 关联上。

    c) 表达式中支持域的数目差异

        Unix cron 提供五个域（分、时、日、月、周），

        Quartz cron 提供七个域（秒、分、时、日、月、周、年）。

 

2. 基本用法

    一个 Cron-表达式是一个由六至七个字段组成由空格分隔的字符串。如下：

    其中 6 个字段是必须的而一个是可选的，月份和星期的名称是不区分大小写的，域之间有空格分隔。

 

3. 特俗字符

    a) – 中划线

        用来指定一个值的范围。例如，在小时域上的 3-8 意味着“3，4，5，6，7，8”点。

        域的值不允许回卷，所以像 8-3 这样的值是不允许的。

    b) * 星号

        星号可以用于所有字段，指示着在这个域上包含所有合法的值，

        在“分”字段中设为"*"表示"每一分钟"的含义。

     c) / 斜杠

         斜杠用来指定一个值的的增加幅度

         i.   增幅举例

              在“秒”字段中设置为"0/15"表示"第 0, 15, 30, 和 45 秒"，而 "5/15"则表示"第 5, 20, 35, 和 50"。                     在'/'前加"*"字符相当于指定从 0 秒开始。

         ii.  概述

              对于“秒”和“分”字段来说，其数值范围为0 到 59，对于“小时”字段来说其为 0 到 23,

              对于“日”字段来说为 0 到 31, 而对于“月”字段来说为 1到 12。

              "/"字段仅仅只是帮助你在允许的数值范围内从开始"第 n"的值。

      d) ? 问号

          问号只能用在“日”和“周”上，但是不能在这两个域上同时使用。

          i.   可以认为问号是 "我并不关心在该域上是什么值"。

          ii.  这不同于星号，星号是指示着该域上的每一个值。? 是说不为该域指定值。

          iii. 切记

              只要记住，假如你为这两域的其中一个指定了值，那就必须在另一个字值上放一个 ?。

      e) L 字母

          'L'字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。

          例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是 31 号对于二月来说

          就是 28 号（非闰年）。而在“周几”字段中, 它简单的表示"7" or "SAT"，

          但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" ——

          比如"6L"表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要，

          否则你会被结果搞糊涂的。

       f) W 字母

          'W' 可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。

          比如你将“日”字段设为"15W"，意为: "离该月 15 号最近的工作日"。

          因此如果 15 号为周六，触发器会在 14 号即周五调用。如果 15 号为周日,

          触发器会在 16 号也就是周一触发。如果 15 号为周二,那么当天就会触发。

          然而如果你将“日”字段设为"1W",而一号又是周六, 触发器会于下周一也就是当月的3号触发,

          因为它不会越过当月的值的范围边界。'W'字符只能用于“日”

          字段的值为单独的一天而不是一系列值的时候。

          'L'和'W'可以组合用于“日”字段表示为'LW'，意为"该月最后一个工作日"。

      g) C 字母

          'C' 字符可用于“日”和“周几”字段，它是"calendar"的缩写。

          它表示为基于相关的日历所计算出的值（如果有的话）。

          如果没有关联的日历, 那它等同于包含全部日历。

          “日”字段值为"5C"表示"日历中的第一天或者 5 号以后"，

          “周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。

       h) # 符号

           '#' 字符可用于“周几”字段。该字符表示“该月第几个周×”，

           比如"6#3"表示该月第三个周五( 6 表示周五而"#3"该月第三个)。

           再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。

           注意如果你指定"#5"该月没有第五个“周×”，该月是不会触发的。

        i) , 逗号

           逗号 (,) 是用来在给某个域上指定一个值列表的。例如，

           使用值 0,15,30,45 在秒域上意味着每 15 秒触发一个 trigger。

 

4. Cron 表达式例子

    此处的 Cron 表达式旨在为常用的执行需求提供方案。尽管不可能列举出所有的表达式，

    但下面的应该为满足你的业务需求提供了足够的例子。

    a) 分钟的 Cron 表达式

每天的从 5:00 PM 至 5:59 PM 中的每分钟触发 0 * 17 * * ?

每天的从 11:00 PM 至 11:55 PM 中的每五分钟触发 0 0/5 23 * * ?

每天的从 3:00 至 3:55 PM 和 6:00 PM 至 6:55 PM 之中的每五分钟触发 0 0/5 15,18 * * ?

每天的从 5:00 AM 至 5:05 AM 中的每分钟触发 0 0-5 5 * * ?

    b) 日上的 Cron 表达式

每天的 3:00 AM 0 0 3 * * ?

每天的 3:00 AM (另一种写法) 0 0 3 ? * *

每天的 12:00 PM (中午) 0 0 12 * * ?

在 2005 中每天的 10:15 AM 0 15 10 * * ? 2005

    c) 周和月的 Cron 表达式

在每个周一,二, 三和周四的 10:15 AM 0 15 10 ? * MON-FRI

每月 15 号的 10:15 AM 0 15 10 15 * ?

每月最后一天的 10:15 AM 0 15 10 L * ?

每月最后一个周五的 10:15 AM 0 15 10 ? * 6L

在 2002, 2003, 2004, 和 2005 年中的每月最后一个周五的 10:15 AM 0

15 10 ? * 6L 2002-2005

每月第三个周五的 10:15 AM 0 15 10 ? * 6#3

每月从第一天算起每五天的 12:00 PM (中午) 0 0 12 1/5 * ?

每一个 11 月 11 号的 11:11 AM 0 11 11 11 11 ?

三月份每个周三的 2:10 PM 和 2:44 PM 0 10,44 14 ? 3 WED

   d) 更多的例子

       表达式 含义

"0 0 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 分每分钟一次触发

"0 0/5 14 * * ?" 每天从下午 2 点开始到 2：55 分结束每 5 分钟一次触发

"0 0/5 14,18 * * ?" 每天的下午 2 点至 2：55 和 6 点至 6 点 55 分两个时

间段内每 5 分钟一次触发

"0 0-5 14 * * ?" 每天 14:00 至 14:05 每分钟一次触发

"0 10,44 14 ? 3 WED" 三月的每周三的 14：10 和 14：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" 每月最后一个周五的 10：15 触发

"0 15 10 ? * 6L 2002-2005" 2002 年至 2005 年的每月最后一个周五的

10：15 触发

"0 15 10 ? * 6#3" 每月的第三个周五的 10：15 触发