定时表达式Corn

刺骨的言语ヽ痛彻心扉 2023-10-12 11:19 32阅读 0赞

## 系列文章目录 ##

--------------------

#### 文章目录 ####

*  系列文章目录
 *  前言
 *  一、域取值
 *  二、特殊字符
 *  三、取值示例
 *  总结

--------------------

## 前言 ##

Cron表达式是一个具有时间含义的字符串，字符串以56个空格隔开，分为67个域，格式为X X X X X X X。其中X是一个域的占位符。最后一个代表年份的域非必须，可省略。单个域有多个取值时，使用半角逗号,隔开取值。每个域可以是确定的取值，也可以是具有逻辑意义的特殊字符。每个域最多支持一个前导零。

说明 设置的最小时间间隔需大于或等于定时任务的超时时间，且不小于10秒。如果不指定时区，默认为执行定时任务实例的系统内部时区。

--------------------

## 一、域取值 ##

下表为Cron表达式中七个域能够取得值以及支持的特殊字符。

<table> 
 <thead> 
  <tr> 
   <th>域</th> 
   <th>是否必需</th> 
   <th>取值范围</th> 
   <th>特殊字符</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>秒</td> 
   <td>是</td> 
   <td>[0, 59]</td> 
   <td>* , - /</td> 
  </tr> 
  <tr> 
   <td>分钟</td> 
   <td>是</td> 
   <td>[0, 59]</td> 
   <td>* , - /</td> 
  </tr> 
  <tr> 
   <td>小时</td> 
   <td>是</td> 
   <td>[0, 23]</td> 
   <td>* , - /</td> 
  </tr> 
  <tr> 
   <td>日期</td> 
   <td>是</td> 
   <td>[1, 31]</td> 
   <td>* , - / ? L W</td> 
  </tr> 
  <tr> 
   <td>月份</td> 
   <td>是</td> 
   <td>[1, 12]或[JAN, DEC]</td> 
   <td>* , - /</td> 
  </tr> 
  <tr> 
   <td>星期</td> 
   <td>是</td> 
   <td>[1, 7]或[MON, SUN]。若您使用[1, 7]表达方式，1代表星期一，7代表星期日</td> 
   <td>* , - / ? L #</td> 
  </tr> 
  <tr> 
   <td>年</td> 
   <td>是</td> 
   <td>[当前年份，2099]</td> 
   <td>* , - /</td> 
  </tr> 
 </tbody> 
</table>

## 二、特殊字符 ##

Cron表达式中的每个域都支持一定数量的特殊字符，每个特殊字符有其特殊含义。

<table> 
 <thead> 
  <tr> 
   <th>特殊字符</th> 
   <th>含义</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>*</td> 
   <td>所有可能的值。</td> 
   <td>在月域中，*表示每个月；在星期域中，*表示星期的每一天。</td> 
  </tr> 
  <tr> 
   <td>,</td> 
   <td>列出枚举值。</td> 
   <td>在分钟域中，5,20表示分别在5分钟和20分钟触发一次。</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>范围。</td> 
   <td>在分钟域中，5-20表示从5分钟到20分钟之间每隔一分钟触发一次。</td> 
  </tr> 
  <tr> 
   <td>/</td> 
   <td>指定数值的增量。</td> 
   <td>在分钟域中，0/15表示从第0分钟开始，每15分钟。在分钟域中3/20表示从第3分钟开始，每20分钟。</td> 
  </tr> 
  <tr> 
   <td>?</td> 
   <td>不指定值，仅日期和星期域支持该字符。</td> 
   <td>当日期或星期域其中之一被指定了值以后，为了避免冲突，需要将另一个域的值设为?。</td> 
  </tr> 
  <tr> 
   <td>L</td> 
   <td>单词Last的首字母，表示最后一天，仅日期和星期域支持该字符。</td> 
   <td>在日期域中，L表示某个月的最后一天。在星期域中，L表示一个星期的最后一天，也就是星期日（SUN）。如果在L前有具体的内容，例如，在星期域中的6L表示这个月的最后一个星期六。</td> 
  </tr> 
  <tr> 
   <td>W</td> 
   <td>除周末以外的有效工作日，在离指定日期的最近的有效工作日触发事件。W字符寻找最近有效工作日时不会跨过当前月份，连用字符LW时表示为指定月份的最后一个工作日。</td> 
   <td>在日期域中5W，如果5日是星期六，则将在最近的工作日星期五，即4日触发。如果5日是星期天，则将在最近的工作日星期一，即6日触发；如果5日在星期一到星期五中的一天，则就在5日触发。</td> 
  </tr> 
  <tr> 
   <td>#</td> 
   <td>确定每个月第几个星期几，仅星期域支持该字符。</td> 
   <td>在星期域中，4#2表示某月的第二个星期四。</td> 
  </tr> 
 </tbody> 
</table>

## 三、取值示例 ##

以下为Cron表达式的取值示例。

<table> 
 <thead> 
  <tr> 
   <th>示例</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0 15 10 ? * *</td> 
   <td>每天上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 * * ?</td> 
   <td>每天上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0 12 * * ?</td> 
   <td>每天中午12:00执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0 10,14,16 * * ?</td> 
   <td>每天上午10:00点、下午14:00以及下午16:00执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0/30 9-17 * * ?</td> 
   <td>每天上午09:00到下午17:00时间段内每隔半小时执行任务</td> 
  </tr> 
  <tr> 
   <td>0 * 14 * * ?</td> 
   <td>每天下午14:00到下午14:59时间段内每隔1分钟执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0-5 14 * * ?</td> 
   <td>每天下午14:00到下午14:05时间段内每隔1分钟执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0/5 14 * * ?</td> 
   <td>每天下午14:00到下午14:55时间段内每隔5分钟执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0/5 14,18 * * ?</td> 
   <td>每天下午14:00到下午14:55、下午18:00到下午18:55时间段内每隔5分钟执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0 12 ? * WED</td> 
   <td>每个星期三中午12:00执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 15 * ?</td> 
   <td>每月15日上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 L * ?</td> 
   <td>每月最后一日上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 ? * 6L</td> 
   <td>每月最后一个星期六上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 ? * 6#3</td> 
   <td>每月第三个星期六上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 10,44 14 ? 3 WED</td> 
   <td>每年3月的每个星期三下午14:10和14:44执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 ? * * 2022</td> 
   <td>2022年每天上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 ? * * *</td> 
   <td>每年每天上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0/5 14,18 * * ? 2022</td> 
   <td>2022年每天下午14:00到下午14:55、下午18:00到下午18:55时间段内每隔5分钟执行任务</td> 
  </tr> 
  <tr> 
   <td>0 15 10 ? * 6#3 2022,2023</td> 
   <td>2022年至2023年每月第三个星期六上午10:15执行任务</td> 
  </tr> 
  <tr> 
   <td>0 0/30 9-17 * * ? 2022-2025</td> 
   <td>2022年至2025年每天上午09:00到下午17:30时间段内每隔半小时执行任务</td> 
  </tr> 
  <tr> 
   <td>0 10,44 14 ? 3 WED 2022/2</td> 
   <td>从2022年开始，每隔两年3月的每个星期三下午14:10和14:44执行任务</td> 
  </tr> 
 </tbody> 
</table>

## 总结 ##

定时执行指按照设置的时间间隔或者时间点执行命令。云助手目前支持以下三种定时执行方式：固定时间间隔执行、仅在指定时间执行一次、基于时钟定时执行。

**固定时间间隔执行**  
基于Rate表达式，按照设置的时间间隔执行命令。时间间隔支持按秒（s）、分钟（m）、小时（h）和天（d）来选择，适用于在固定时间间隔执行任务的场景。

使用固定时间间隔执行有以下限制：

设置的时间间隔不大于7天、不小于60秒，且需大于定时任务的超时时间。

执行间隔只基于固定频率，与任务实际执行需要的时间无关。例如设置每5分钟执行一次命令，任务需要2分钟执行完成，则在任务完成3分钟后继续执行下一轮。

创建任务时不会立即执行。例如设置每5分钟执行一次命令，创建任务时不会立即执行一次命令，而是在任务创建完成后的5分钟后开始执行。

**仅在指定时间执行一次**  
按照设置的时区和执行时间点执行一次命令，适用于在指定时间执行一次任务的场景。如果不指定时区，默认为UTC时区。

**说明** 例如设置执行时间为2022-05-17 17:30:50，时区为(GMT+8:00) Asia/Shanghai，即表示系统会在中国/上海时间，2022年05月17日17点30分50秒执行一次命令。  
**基于时钟定时执行**  
基于Cron表达式，按照设置的执行频率执行命令。执行频率可精确到秒、分钟、小时、日期、月份、星期、年份，在指定的时区下，根据Cron表达式推算定时任务执行时间并执行。配置灵活，适用于较复杂的定时任务执行场景。