更新时间:2023-03-01 GMT+08:00

附录:QuartZ Cron表达式配置说明

参数说明

数据集成任务支持使用QuartZ Cron表达式配置定时任务的调度计划。

QuartZ Cron表达式由6个部分组成,每个部分使用空格隔开。表达式中的六个部分从左到右代表的含义如下:

秒 分 时 日 月 周

具体参数如表1所示。

表1 QuartZ Cron参数说明

名称

是否必填

可选数值

可选特殊符号

否,该配置项暂不支持

固定为0。

-

数字0-59。

, - * /

数字0-23。

, - * /

每月中的一天,数字1-31。注意2月没有30日和31日,4月、6月、9月、11月没有31日。

, - * ? / L W

数字1-12,或字符串。数字与字符串的对应关系请参见表2

假如您想在月参数中填写1月,数字“1”或字符串“JAN”都符合QuartZ Cron表达式的约定。

, - * /

数字1-7,或字符串。数字与字符串的对应关系请参见表3,QuartZ Cron表达式约定周六为每周的最后一天。

假如您想在周参数中填写周一,数字“2”或字符串“MON”都符合QuartZ Cron表达式的约定。

, - * ? / L #

表2 月参数的数字与字符串对应关系

数字

字符串

1

JAN

2

FEB

3

MAR

4

APR

5

MAY

6

JUN

7

JUL

8

AUG

9

SEP

10

OCT

11

NOV

12

DEC

表3 每周数字与字符串对应表

数字

字符串

含义

1

SUN

周日

2

MON

周一

3

TUE

周二

4

WED

周三

5

THU

周四

6

FRI

周五

7

SAT

周六

注意事项

每一个参数都使用数字,但还可以出现如下特殊字符。

  • *:表示匹配该域的任意值。假如在“分”使用“*”,即表示每分钟都会触发事件。
  • ?:只能用在“日(每月中的一天)”和“周”两个参数中。它也匹配参数的任意值,但实际不会。因为“日(每月中的一天)”和“周”会相互影响。例如想在每月的20日触发调度,不管20日是星期几,则只能使用如下写法: 13 13 15 20 * ?,其中最后一位只能用“?”,而不能使用“*”,如果使用“*”表示不管星期几都会触发,实际上并不是这样。
  • -:表示范围。例如在“分”使用“5-20”,表示从5分到20分钟每分钟触发一次。
  • /:表示起始时间开始触发,然后每隔固定时间触发一次。例如在“分”使用“5/20”,则表示每小时的第5、25、45分钟分别触发定时任务。
  • ,:表示列表值。例如:在“分”使用“5,20”,则表示在每小时的第5分和20分触发一次定时任务。
  • L:表示最后,只能出现在“日(每月中的一天)”和“周”参数中。如果在“周”域使用“5L”表示在最后的一个星期四触发。
  • W:表示有效工作日(周一到周五),只能出现在“日(每月中的一天)”参数中,系统将在离指定日期的最近的有效工作日触发事件。例如:在 “日(每月中的一天)”使用“5W”,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。W的最近寻找不会跨过月份 。
  • LW:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。
  • #:用于确定每个月第几个星期几,只能出现在“日(每月中的一天)”域。例如在4#2,表示某月的第二个星期三。

配置示例

以下示例将帮助您更好地理解QuartZ Cron表达式的含义。简单示例展示了QuartZ Cron表达式的初级使用方法,常用示例则展示了QuartZ Cron表达式在实际场景中常见的使用方法,您只需根据实际需求对常用示例进行微调即可直接使用。

简单示例:
0 0/1 * * * ? //每隔一分钟执行一次
0 0 23 * * ? //每天23点执行一次
0 0 1 1 * ? //每月一号凌晨1点执行一次
0 0 23 L * ? //每月最后一天23点执行一次
0 33,55 * * * ? //在33分,55分执行一次
0 0 18  * * LW //每月最后一个工作日晚上六点执行一次
常用示例:
0 0 12 * * ? //每天中午12点执行一次 。
0 * 14 * * ? //在每天下午2点到下午2:59期间的每1分钟执行一次 。
0 0/30 9-19 * * ? //上午9点到下午19:59期间每半小时执行一次。
0 0 12 ? * WED //每个星期三中午12点执行一次。
0 0/30 9-19 * * MON-FRI //周一到周五,早上9点至下午19:59点期间,每半小时执行一次。
0 15 10 ? * MON-FRI //周一到周五每天上午10:15执行一次。
0 0 2 1 * ? //在每月的1日的凌晨2点执行一次。
0 15 10 ? * 6#3 //每月的第三个星期五上午10:15执行一次。
0 15 10 ? * 6L //每月的最后一个星期五上午10:15执行一次。