cron 式
別名: cron / crontab / cron expression / cron 構文
「分 時 日 月 曜日」の 5 つのフィールドで定期実行の時刻を表す書式。
crontab のほか GitHub Actions の schedule や Vercel Cron Jobs でも使われ、多くのサービスでは UTC で解釈される。
公開:
定義
cron 式は、空白で区切った 5 つのフィールド「分(0〜59)・時(0〜23)・日(1〜31)・月(1〜12)・曜日(0 が日曜)」で定期実行のタイミングを表す書式である。* は「毎」、*/15 は「15 ごと」、1,15 は列挙を意味する。
元は Unix の cron デーモンが読む crontab の書式である。
詳細
17 21 * * 1-5 # 月〜金の 21:17(UTC なら JST の翌朝 6:17)GitHub Actions の on.schedule と Vercel Cron Jobs も同じ 5 フィールドを使う。
どちらも既定は UTC で、Vercel は常に UTC、GitHub Actions は timezone を書いたときだけ別のタイムゾーンで解釈する。
GitHub Actions の最短間隔は 5 分で、毎時 0 分のような混む時刻は遅れやすい。
Vercel は MON のような名前表記に対応せず、日と曜日を同時に指定できない。
よくある誤解
- cron 式に書いた時刻が、ローカル時刻で解釈されるとは限らない。
多くのサービスは UTC なので、0 0 * * *は JST の 9:00 になる。 - 日と曜日を両方指定しても、両方を満たす日だけに動くわけではない。
crontab では両方を指定すると、どちらか一方に合う日に動く。
関連
定刻に動かないときは GitHub Actions の schedule と Vercel Cron Jobs で扱っている。
cron から動くシェルが起動ファイルを読まない点は PATH が反映されない で扱う。