AnalyticDB PostgreSQL版設置周期執行的計劃時,需要使用Cron表達式,本文為您介紹什么是Cron表達式以及相關示例。

Cron表達式是一個具有時間含義的字符串,字符串以5~6個空格隔開,分為6~7個域,格式為秒 分鐘 小時 日期 月份 星期 年。最后一個代表年份的域非必須,可省略。單個域有多個取值時,使用半角逗號(,)隔開取值。每個域可以是確定的取值,也可以是通配符。

域取值

下表為Cron表達式中六個域的取值范圍以及支持的通配符。

是否必需 取值范圍 通配符
[0, 59] * , - /
分鐘 [0, 59] * , - /
小時 [0, 23] * , - /
日期 [1, 31] * , - / ? L W
月份 [1, 12]或[JAN, DEC] * , - /
星期 [1, 7]或[MON, SUN]。若您使用[1, 7]表達方式,1代表星期一,7代表星期日。 * , - / ? L #
[1970,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表示某月的第二個星期四。

示例

以下為Cron表達式的取值示例。

注意 計劃管理的Cron表達式使用的是UTC時間,實際使用時請將北京時間轉換成UTC時間。
場景 示例(場景為UTC時間時) 示例(場景為北京時間時)
每天上午10:15執行計劃 0 15 10 ? * * 0 15 18 ? * *
每天上午10:15執行計劃 0 15 10 * * ? 0 15 18 * * ?
每天中午12:00執行計劃 0 0 12 * * ? 0 0 20 * * ?
每天上午10:00點、下午14:00以及下午16:00執行計劃 0 0 10,14,16 * * ? 0 0 18,22,0 * * ?
每天上午09:00到下午17:00時間段內每隔半小時執行計劃 0 0/30 9-17 * * ? 0 0/30 17-2 * * ?
每天下午14:00到下午14:59時間段內每隔1分鐘執行計劃 0 * 14 * * ? 0 * 22 * * ?
每天下午14:00到下午14:05時間段內每隔1分鐘執行計劃 0 0-5 14 * * ? 0 0-5 22 * * ?
每天下午14:00到下午14:55時間段內每隔5分鐘執行計劃 0 0/5 14 * * ? 0 0/5 22 * * ?
每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行計劃 0 0/5 14,18 * * ? 0 0/5 22,3 * * ?
每個星期三中午12:00執行計劃 0 0 12 ? * WED 0 0 20 ? * WED
每月15日上午10:15執行計劃 0 15 10 15 * ? 0 15 18 15 * ?
每月最后一日上午10:15執行計劃 0 15 10 L * ? 0 15 18 L * ?
每月最后一個星期六上午10:15執行計劃 0 15 10 ? * 6L 0 15 18 ? * 6L
每月第三個星期六上午10:15執行計劃 0 15 10 ? * 6#3 0 15 18 ? * 6#3
每年3月的每個星期三下午14:10和14:44執行計劃 0 10,44 14 ? 3 WED 0 10,44 22 ? 3 WED
2022年每天上午10:15執行計劃 0 15 10 ? * * 2022 0 15 18 ? * * 2022
每年每天上午10:15執行計劃 0 15 10 ? * * * 0 15 18 ? * * *
2022年每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行計劃 0 0/5 14,18 * * ? 2022 0 0/5 22,3 * * ? 2022
2022年至2023年每月第三個星期六上午10:15執行計劃 0 15 10 ? * 6#3 2022,2023 0 15 18 ? * 6#3 2022,2023
2022年至2025年每天上午09:00到下午17:30時間段內每隔半小時執行計劃 0 0/30 9-17 * * ? 2022-2025 0 0/30 17-2 * * ? 2022-2025
從2022年開始,每隔兩年3月的每個星期三下午14:10和14:44執行計劃 0 10,44 14 ? 3 WED 2022/2 0 10,44 22 ? 3 WED 2022/2