通過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]表達方式, 重要 Cron表達式的使用方法和含義可能會根據不同的系統、框架或工具有所差異。若您在其他地方使用Cron表達式,1可能表示星期日,7表示星期六,具體以實際情況為準。 | * , - / ? L # |
年 | 否 | [當前年份,2099] | * , - / |
特殊字符
Cron表達式中的每個字段都支持特殊字符,每個特殊字符都有其特殊含義。
特殊字符 | 含義 | 示例 |
| 匹配任意值。 | 在字段 |
| 列出枚舉值。 | 在字段 |
| 指定范圍。 | 在字段 |
| 指定數值的增量。 | 在字段 |
| 不指定值,僅用于日期和星期。 | 當字段 |
| 單詞Last的首字母,表示最后一天,僅字段 重要 指定 |
|
| 除周末以外的有效工作日,在離指定日期的最近的有效工作日觸發事件。 | 在字段 |
| 確定每個月的第幾個星期幾。 重要 僅字段 | 在字段 |
示例
場景 | 取值 | |
每天固定時間執行 | 每天上午10:15執行任務 |
|
每天中午12:00執行任務 |
| |
每天多個固定時間執行 | 每天上午10:00點、下午14:00以及下午16:00執行任務 |
|
每間隔一段時間執行 | 每天上午09:00到下午17:00時間段內每隔半小時執行任務 |
|
每天下午14:00到下午14:59時間段內每隔1分鐘執行任務 |
| |
每天下午14:00到下午14:05時間段內每隔1分鐘執行任務 |
| |
每天下午14:00到下午14:55時間段內每隔5分鐘執行任務 |
| |
每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行任務 |
| |
特定星期/日期執行 | 每個星期三中午12:00執行任務 |
|
每月15日上午10:15執行任務 |
| |
每月最后一日上午10:15執行任務 |
| |
每月最后一個星期六上午10:15執行任務 |
| |
每月第三個星期六上午10:15執行任務 |
| |
特定年份的特定日期執行 | 每年3月的每個星期三下午14:10和14:44執行任務 |
|
2022年每天上午10:15執行任務 |
| |
每年每天上午10:15執行任務 |
| |
2022年每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行任務 |
| |
2022年至2023年每月第三個星期六上午10:15執行任務 |
| |
2022年至2025年每天上午09:00到下午17:30時間段內每隔半小時執行任務 |
| |
從2022年開始,每隔兩年3月的每個星期三下午14:10和14:44執行任務 |
|