Skip to content

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-179 から 17 までの各値
リスト1,15列挙した各値
間隔*/15、0-30/1015 ごと、0 から 30 まで 10 ごと
名前mon、jan-mar曜日名と月名(大文字小文字は問いません)

日と曜日の両方を制限した場合は、標準の cron と同じく どちらか が一致すれば実行します。0 0 1 * mon は 1 日と毎週月曜に実行されます。

受け付けないもの:6 番目(秒)のフィールド、L、W、#、?。最短の間隔は 1 分です。

エイリアス ​

エイリアス同じ意味
@hourly0 * * * *
@daily、@midnight0 0 * * *
@weekly0 0 * * 0
@monthly0 0 1 * *
@yearly、@annually0 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-friAmerica/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 回の実行時刻を返します。関数をスケジュールで実行する を参照してください。