v1.2.1

排程語法

最後更新


本頁列出 Add 接受的 spec 格式:五欄位 Cron 表達式、描述符與 @every 固定間隔。

Cron 表達式


固定五欄位,以設定的 Location 計算:
欄位範圍
分0-59
時0-23
日1-31
月1-12
週0-6(0 為週日)

語法範例比對規則
**任意值
n30等於 n
n-m9-17介於 n 與 m(含)
a,b,n-m0,30列表,可混用範圍,重複值去除
*/n*/15欄位值可被 n 整除

*/n 比對的是欄位值本身,而非從欄位最小值起算的位移:日欄位的 */5 符合 5、10、15、20、25、30 日,月欄位的 */2 符合偶數月。不支援 n-m/s 形式與月份、星期的英文名稱。下次觸發時間由下一分鐘開始逐分鐘遞增,直到五個欄位全部符合。

描述符與固定間隔


spec等同
@yearly、@annually0 0 1 1 *
@monthly0 0 1 * *
@weekly0 0 * * 0
@daily、@midnight0 0 * * *
@hourly0 * * * *
@every <duration>以 time.ParseDuration 解析;最小 30 秒;下次觸發 = 本次觸發被處理的時間 + duration

時區設定見 設定,解析錯誤見 任務 API。
EN