使い方
- 上の欄に cron 式を入力すると、意味を日本語で表示し、次に実行される日時を一覧にします。入力するそばから結果が変わります。
- crontab の行をそのまま貼り付けても構いません。6 項目め以降はコマンドとして扱い、式の部分だけを読み取ります。
- 実行日時は「日本時間」と「UTC」を切り替えられます。サーバーのタイムゾーンが UTC のままになっていることはよくあるので、本番環境の設定に合わせて確認してください。
- 書き方に迷ったら、下のボタン(プリセット)から近いものを選んで書き換えるのが早道です。
cron 式の書き方
cron(クーロン)は、Linux や macOS などで決まった時刻にコマンドを自動で実行する仕組みです。実行のタイミングは、空白で区切った 5 つの項目で指定します。
┌───────── 分(0〜59)
│ ┌─────── 時(0〜23)
│ │ ┌───── 日(1〜31)
│ │ │ ┌─── 月(1〜12 または JAN〜DEC)
│ │ │ │ ┌─ 曜日(0〜7 または SUN〜SAT。0 と 7 はどちらも日曜日)
│ │ │ │ │
0 9 * * 1-5 /home/user/report.sh| 記号 | 意味 | 例 |
|---|---|---|
* | すべての値 | 時に * → 毎時 |
, | 値を並べる | 0,30 → 0 分と 30 分 |
- | 範囲 | 9-17 → 9 時から 17 時まで |
/ | 間隔 | */15 → 15 分ごと、1-10/3 → 1・4・7・10 |
| 名前 | 月と曜日は英語 3 文字でも書ける(大文字・小文字は区別しない) | MON-FRI、JAN,JUL |
次の書き方(マクロ)も使えます。@reboot だけは時刻ではなく、cron が起動したとき(多くの場合はサーバーの起動時)に 1 回実行されます。
| マクロ | 同じ意味の式 | 意味 |
|---|---|---|
@yearly(@annually) | 0 0 1 1 * | 毎年 1 月 1 日 0:00 |
@monthly | 0 0 1 * * | 毎月 1 日 0:00 |
@weekly | 0 0 * * 0 | 毎週日曜日 0:00 |
@daily(@midnight) | 0 0 * * * | 毎日 0:00 |
@hourly | 0 * * * * | 毎時 0 分 |
@reboot | — | 起動時に 1 回 |
日と曜日を両方指定したときの注意(OR になる)
cron でいちばん間違えやすいのがこの点です。日(3 番目)と曜日(5 番目)の両方を * 以外にすると、「両方に当てはまる日」ではなく「どちらか一方に当てはまる日」に実行されます(POSIX で決められた動き)。
たとえば 0 9 1-7 * 1 は「第 1 月曜日」のつもりで書かれがちですが、実際には「毎月 1〜7 日の毎日」と「毎週月曜日」の両方で実行されます。第 1 月曜日だけに動かしたいときは、曜日だけを指定してスクリプトの中で日付を確かめます。
0 9 * * 1 [ "$(date +\%d)" -le 7 ] && /home/user/monthly.shcrontab の中では % が改行の意味になるため、\% のようにエスケープします。
なお Linux で広く使われている Vixie cron(cronie)は、日か曜日のどちらかが * で始まるときは AND として扱います。0 0 */2 * 1 は「奇数日かつ月曜日」になります。このツールの計算もこの動きに合わせています。
具体例
| cron 式 | 意味 |
|---|---|
*/5 * * * * | 5 分ごと(0 分・5 分・10 分…) |
0 */3 * * * | 3 時間ごと(0:00・3:00・6:00…) |
30 2 * * * | 毎日 2:30(深夜のバックアップなど) |
0 9 * * 1-5 | 平日の 9:00 |
0 18 * * 5 | 毎週金曜日の 18:00 |
0 0 1,15 * * | 毎月 1 日と 15 日の 0:00 |
0 0 1 */3 * | 3 か月ごと(1・4・7・10 月)の 1 日 0:00 |
0 4 * * sun | 毎週日曜日の 4:00 |
よくある質問
- 月末に実行するには?
- 標準の cron には「月末」を表す書き方がありません。
0 0 28-31 * *で毎月 28〜31 日に起動し、スクリプトの中で「明日が 1 日かどうか」(GNU date なら[ "$(date -d tomorrow +\%d)" = 01 ])を確かめる方法がよく使われます。31とだけ書くと、31 日がない月には実行されません。 - 秒単位や 6 項目の cron 式は使えますか?
- このツールは crontab の標準の 5 項目に対応しています。先頭に秒を付ける Quartz・Spring の形式や、年を加える AWS EventBridge の形式、
?・L・W・#といった拡張記号は読み取れません。入力するとその旨を表示します。 - 時刻がずれて実行されます
- cron はサーバー(コンテナ)のタイムゾーンで動きます。クラウドのサーバーや Docker では UTC になっていることが多く、その場合
0 9 * * *は日本時間の 18:00 に実行されます。timedatectlやdateコマンドで確認するか、cronie なら crontab にCRON_TZ=Asia/Tokyoを書く方法があります。GitHub Actions のscheduleも UTC です。 - 実行されたか確かめるには?
- 多くの Linux では
/var/log/cronやjournalctl -u cron(ディストリビューションによりcrond)にログが残ります。cron から実行するときは環境変数PATHが最小限になるので、コマンドはフルパスで書き、出力をファイルに残しておくと原因を追いやすくなります。 - 入力した内容はどこかに送られますか?
- 送られません。解析と日時の計算はすべてお使いのブラウザの中で行っています。
最終更新: