schedule Cron式ジェネレーター star

仕組み

cron式は、常に同じ順序で並んだ5つの空白区切りフィールドを使って繰り返しジョブをスケジュールします — 分・時・日（月内）・月・曜日です。各フィールドには値、または4種類の特殊文字のいずれかを指定できます。*は「すべての値」を意味し、*/15は「そのフィールドの最小値から15単位ごと」、1,15,30は明示的なリスト、1-5は両端を含む範囲を表します。左から右へ読むと、0 9 * * 1-5は「9時の0分に、月内の毎日、毎月、曜日1から5にかけて」という意味になり、つまり月曜から金曜の午前9時です。*/10 * * * *は終日10分ごとに実行され、0 0 1 * *は毎月1日の深夜0時に実行されます。

ドロップダウンからスケジュールを組み立てると、このツールが5つのフィールドを組み立て、その結果を平易な文章に翻訳するので、crontabファイルやクラウドスケジューラに貼り付ける前に内容を確認できます。よく使われるプリセット — 毎分、毎時、毎日決まった時刻に、平日のみ — は、人々が最も頻繁に求めるスケジュールをワンクリックで用意します。

知っておくべきこと

cronの意味論で最も大きな驚きは次の点です。日（月内）と曜日の両方が制限されている場合（どちらも*のままではない場合）、この2つはANDではなくORで結合されます。つまり0 0 15 * 5は「15日、ただしそれが金曜日である場合」を意味するのではなく、「毎月15日、または毎週金曜日」を意味し、これは多くの人が意図するよりもはるかに頻繁に実行されます。片方だけを気にしたい場合は、もう片方を*のままにしておいてください。

曜日の番号付けにも注意が必要です。ほとんどのcron実装では0と7の両方が日曜日を意味し、月曜日は1です。そして決定的に重要なのは、cronは常にサーバーに設定されたタイムゾーンで実行されるという点です — クラウドインフラでは一般にUTC — スケジュールを設定した人のローカルタイムゾーンではありません。そのため「午前9時」に設定したジョブが、ホストのタイムゾーンを確認するまでは想定と異なる現地時刻に実行されることがあります。GitHub Actionsのschedule:、AWS EventBridge、KubernetesのCronJobといったクラウドスケジューラは、いずれもこの同じ5フィールド構文を基盤としており、ベンダー固有の拡張(オプションの秒フィールド、曜日名の省略記法など)が加わることもあります。そのため、ここで組み立てたスケジュールはほとんど変換なしにこれらのプラットフォームへそのまま移行できます。