cron の書式
cron の schedule は空白で区切った 5 つのフィールド、または下のエイリアスのどれかです。timezone は、フィールドをどの時計で読むかを指定します。
text
┌───────── 分 0–59
│ ┌─────── 時 0–23
│ │ ┌───── 日 1–31
│ │ │ ┌─── 月 1–12 または jan–dec
│ │ │ │ ┌─ 曜日 0–7 または sun–sat(0 と 7 は日曜)
│ │ │ │ │
0 9 * * mon-friフィールドの書き方
| 形式 | 例 | 意味 |
|---|---|---|
| 数値 | 30 | その値だけ |
* | * | すべての値 |
| 範囲 | 9-17 | 9 から 17 までの各値 |
| リスト | 1,15 | 列挙した各値 |
| 間隔 | */15、0-30/10 | 15 ごと、0 から 30 まで 10 ごと |
| 名前 | mon、jan-mar | 曜日名と月名(大文字小文字は問いません) |
日と曜日の両方を制限した場合は、標準の cron と同じく どちらか が一致すれば実行します。0 0 1 * mon は 1 日と毎週月曜に実行されます。
受け付けないもの:6 番目(秒)のフィールド、L、W、#、?。最短の間隔は 1 分です。
エイリアス
| エイリアス | 同じ意味 |
|---|---|
@hourly | 0 * * * * |
@daily、@midnight | 0 0 * * * |
@weekly | 0 0 * * 0 |
@monthly | 0 0 1 * * |
@yearly、@annually | 0 0 1 1 * |
タイムゾーン
timezone は Asia/Tokyo、America/New_York、Europe/London のような IANA 名です。既定は UTC です。JST や EST のような略称は受け付けません。曖昧なものがあり、残っている古いものは夏時間を無視するためです。
| スケジュール | タイムゾーン | 実行時刻(UTC) |
|---|---|---|
0 9 * * * | Asia/Tokyo | 毎日 00:00 |
0 9 * * mon-fri | America/New_York | 平日の 13:00(夏)、14:00(冬) |
*/30 * * * * | UTC | 毎時 :00 と :30 |
応答の next_run_at は UTC、next_run_local は cron のタイムゾーンでの時刻です。
夏時間
- 存在しない時刻(時計が進む日):次の有効な分に実行します。
America/New_Yorkの30 2 * * *は、切り替わる日に 03:00 に実行されます。 - 2 回ある時刻(時計が戻る日):最初の 1 回だけ実行します。
取りこぼした実行と遅れた実行
Edge は毎分確認し、予定時刻からおよそ 1 分以内に cron を実行します。予定どおりに実行できなかった cron は、何回分たまっていても、追いついたときに 1 回だけ 実行します。24 時間を超えて遅れて到達した実行は missed として記録し、実行しません。cron.run.missed を購読している Webhook に通知されます。
スケジュールを確かめる
edge_cron_check、edge crons check、POST /v1/distributions/{id}/crons/check は、何も作らずにスケジュールを解析し、次の 5 回の実行時刻を返します。関数をスケジュールで実行する を参照してください。