全部產品
Search
文件中心

Elastic Compute Service:Cron運算式

更新時間:Aug 02, 2024

通過API或ECS控制台等執行雲助手命令時,可基於Cron運算式設定雲助手命令的定時執行計畫。本文介紹Cron運算式的基本文法及其用法樣本。

Cron運算式基本文法

Cron運算式是一種用於指定定時任務的時間運算式,常用來指定任務的執行時間、執行頻率和執行間隔。它由6~7個欄位組成,分別表示秒、分、時、日期、月份、星期、年份(可省略)。

Cron運算式的基本文法如下:

秒 分 時 日期 月份 星期 [年份]
  • [年份]:可省略。

  • 關於單個欄位:

    • 單個欄位可以是一個具體的值、一個範圍、一個遞增步長,或者具有邏輯意義的特殊字元。

    • 單個欄位若有多個取值時,使用半形逗號,隔開取值。

    • 每個欄位最多支援一個前置字元為零。即可以使用01、02等表示,但不能使用001、002等表示。

欄位的取值範圍和支援的特殊字元,請參見欄位取值樣本

欄位取值

下表為Cron運算式中七個欄位的取值範圍和支援的特殊字元。

欄位

是否必需

取值範圍

特殊字元

[0, 59]

* , - /

分鐘

[0, 59]

* , - /

小時

[0, 23]

* , - /

日期

[1, 31]

* , - / ? L W

月份

[1, 12]或[JAN, DEC]

* , - /

星期

[1, 7]或[MON, SUN]。在雲助手命令中,若您使用[1, 7]表達方式,1代表星期一,7代表星期日。

重要

Cron運算式的使用方法和含義可能會根據不同的系統、架構或工具有所差異。若您在其他地方使用Cron運算式,1可能表示星期日,7表示星期六,具體以實際情況為準。

* , - / ? L #

[當前年份,2099]

* , - /

特殊字元

Cron運算式中的每個欄位都支援特殊字元,每個特殊字元都有其特殊含義。

特殊字元

含義

樣本

*

匹配任意值。

在欄位中,*表示每個月。

,

列出枚舉值。

在欄位分鐘中,5,20表示分別在5分鐘和20分鐘觸發一次。

-

指定範圍。

在欄位分鐘中,5-20表示從5分鐘到20分鐘之間每隔一分鐘觸發一次。

/

指定數值的增量。

在欄位分鐘中,0/15表示從第0分鐘開始,每15分鐘。在欄位分鐘3/20表示從第3分鐘開始,每20分鐘。

?

不指定值,僅用於日期和星期。

當欄位日期星期其中之一被指定了值以後,為了避免衝突,需要將另一個欄位的值設為?

L

單詞Last的首字母,表示最後一天,僅欄位日期星期支援該字元。

重要

指定L字元時,避免指定列表或範圍,否則會導致邏輯問題。

  • 在欄位日期中,L表示某個月的最後一天。在欄位星期中,L表示一個星期的最後一天,也就是星期日(SUN)。

  • 如果在L前有具體的內容,例如,在欄位星期中的6L表示這個月的最後一個星期六。

W

除周末以外的有效工作日,在離指定日期的最近的有效工作日觸發事件。W字元尋找最近有效工作日時不會跨過當前月份,連用字元LW時表示為指定月份的最後一個工作日。

在欄位日期5W,如果5日是星期六,則將在最近的工作日星期五,即4日觸發。如果5日是星期天,則將在最近的工作日星期一,即6日觸發;如果5日在星期一到星期五中的一天,則就在5日觸發。

#

確定每個月的第幾個星期幾。

重要

僅欄位星期支援該字元。

在欄位星期中,4#2表示某月的第二個星期四。

樣本

情境

取值

每天固定時間執行

每天上午10:15執行任務

0 15 10 ? * *

每天中午12:00執行任務

0 0 12 * * ?

每天多個固定時間執行

每天上午10:00點、下午14:00以及下午16:00執行任務

0 0 10,14,16 * * ?

每間隔一段時間執行

每天上午09:00到下午17:00時間段內每隔半小時執行任務

0 0/30 9-17 * * ?

每天下午14:00到下午14:59時間段內每隔1分鐘執行任務

0 * 14 * * ?

每天下午14:00到下午14:05時間段內每隔1分鐘執行任務

0 0-5 14 * * ?

每天下午14:00到下午14:55時間段內每隔5分鐘執行任務

0 0/5 14 * * ?

每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行任務

0 0/5 14,18 * * ?

特定星期/日期執行

每個星期三中午12:00執行任務

0 0 12 ? * WED

每月15日上午10:15執行任務

0 15 10 15 * ?

每月最後一日上午10:15執行任務

0 15 10 L * ?

每月最後一個星期六上午10:15執行任務

0 15 10 ? * 6L

每月第三個星期六上午10:15執行任務

0 15 10 ? * 6#3

特定年份的特定日期執行

每年3月的每個星期三下午14:10和14:44執行任務

0 10,44 14 ? 3 WED

2022年每天上午10:15執行任務

0 15 10 ? * * 2022

每年每天上午10:15執行任務

0 15 10 ? * * *

2022年每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行任務

0 0/5 14,18 * * ? 2022

2022年至2023年每月第三個星期六上午10:15執行任務

0 15 10 ? * 6#3 2022,2023

2022年至2025年每天上午09:00到下午17:30時間段內每隔半小時執行任務

0 0/30 9-17 * * ? 2022-2025

從2022年開始,每隔兩年3月的每個星期三下午14:10和14:44執行任務

0 10,44 14 ? 3 WED 2022/2