AWS cron 式ビルダーとバリデーター
式を作成してチェック
すべてブラウザ内で、オフラインでも動作します。入力した内容はどこにも送信されません。ページのアドレスをコピーすればスケジュールを共有でき、式は # の後ろに保存されます。
AWS の cron 式は、分、時、日、月、曜日、年の 6 つのフィールドを cron() で囲んだものです。cron(0 9 ? * MON-FRI *) は平日の毎日 09:00 に実行されます。2 つの日付フィールドのどちらかは ? にする必要があり、曜日は 1 = 日曜日〜7 = 土曜日で数えます。EventBridge ルールは UTC で実行され、EventBridge Scheduler は任意のタイムゾーンを使えます。
AWS cron の構文:6 つのフィールド
EventBridge のスケジュールされたルールと EventBridge Scheduler は同じ cron 形式を使います:cron(minutes hours day-of-month month day-of-week year)。6 つのフィールドはすべて必須で、スペースで区切ります。
| フィールド | 値 | ワイルドカード |
|---|---|---|
| 分 | 0–59 | , - * / |
| 時 | 0–23 | , - * / |
| 日 | 1–31 | , - * ? / L W |
| 月 | 1〜12 または JAN〜DEC | , - * / |
| 曜日 | 1〜7 または SUN〜SAT(1 = 日曜日) | , - * ? L # |
| 年 | 1970–2199 | , - * / |
ワイルドカード
,は値を追加します。月フィールドのJAN,FEB,MARは 1 月、2 月、3 月です。-は範囲です。日フィールドの1-15は 1 日〜15 日です。AWS 自身の例には、時フィールドで深夜 0 時をまたぐ範囲20-2もあります。*はすべての値です。日と曜日の両方で同時には使えません。/は増分です。分フィールドの1/10は 1 分、11 分、21 分…に実行され、0/15は毎時 0 分から 15 分ごとです。曜日では使えません。?は「任意」を意味し、使わない方の日付フィールドに入れます。日に7、曜日に?とすると、曜日にかかわらず 7 日に実行されます。Lは最終日です。日フィールドでは月の最終日、曜日フィールドでは週の最終日です。曜日の6Lは月の最終金曜日です。Wは最も近い平日です。3Wは月の 3 日に最も近い平日です。#は月の第 n 曜日です。3#2は第 2 火曜日です(3 は週の 3 日目の火曜日)。#を含む曜日フィールドにはその式 1 つしか書けないため、3#1,6#3は無効です。
どの式にも 2 つの制限があります。日付フィールドを両方指定することはできず(一方は ?)、1 分に 2 回以上実行される cron 式はサポートされません。
例
| 式 | 実行タイミング |
|---|---|
cron(0 10 * * ? *) | 毎日 10:00 UTC |
cron(15 12 * * ? *) | 毎日 12:15 UTC |
cron(0 18 ? * MON-FRI *) | 月曜〜金曜の 18:00 UTC |
cron(0 8 1 * ? *) | 毎月 1 日の 08:00 UTC |
cron(0/15 * * * ? *) | 15 分ごと |
cron(0/10 * ? * MON-FRI *) | 月曜〜金曜に 10 分ごと |
cron(0/5 8-17 ? * MON-FRI *) | 月曜〜金曜の 08:00〜17:55 UTC に 5 分ごと |
cron(15 10 ? * 6L 2019-2022) | 2019〜2022 年の毎月最終金曜日の 10:15 UTC |
cron(0 12 ? * 3#2 *) | 毎月第 2 火曜日の 12:00 |
cron(0 9 15W * ? *) | 15 日に最も近い平日の 09:00 |
最初の 8 つは AWS のドキュメントからの例です。EventBridge ルールでは時刻は UTC、EventBridge Scheduler ではスケジュールのタイムゾーンです。
AWS cron と Unix cron の違い
crontab の行はそのままでは動きません。ビルダーに貼り付けると、AWS 版を提案します。
| 違い | Unix cron | AWS cron |
|---|---|---|
| フィールド | 5 つ:分、時、日、月、曜日 | 6 つ:同じ 5 つに年を加え、cron( ) で囲む |
| 日と曜日 | 両方指定でき、両方を制限した場合はどちらかが一致すれば実行 | どちらかは ? にする必要があり、両方は制限できない |
| 日曜日 | 0(多くの実装では 7 も)。曜日は 0〜6 | 1。曜日は 1〜7、SUN〜SAT |
| 5 分ごと | */5 * * * * | cron(0/5 * * * ? *) または rate(5 minutes) |
| 曜日での増分 | 多くの実装で使用可 | 使用不可:曜日を列挙する |
| L、W、# | 標準の cron にはない | 最終日(L、6L)、最も近い平日(15W)、第 n 曜日(3#2) |
| タイムゾーン | サーバーのタイムゾーン | EventBridge ルールは UTC。EventBridge Scheduler はスケジュールごとに任意の IANA タイムゾーン |
どちらにも秒のフィールドはありません。Quartz と Spring の式には秒があるので、最初のフィールドを削除すると AWS の形式になります。
rate() 式
一定の間隔なら rate(value unit) の方が簡単です:rate(5 minutes)、rate(1 hour)、rate(12 hours)、rate(1 day)。値は正の整数、単位は分、時間、日のいずれかで、秒、週、月はありません。
- EventBridge ルールでは、値が 1 のときは単数形、1 を超えるときは複数形の単位が必要です。
rate(1 hour)とrate(5 hours)は有効、rate(1 hours)とrate(5 hour)は無効です。 - EventBridge Scheduler のガイドは単位を
minutes | hours | daysと記載し、本文でもrate(1 days)と書いています。
rate スケジュールは時計ではなく開始時点から数えます。ルールを作成した時点、または Scheduler のスケジュールの StartDate からです(指定がなければすぐに呼び出しを始めます)。特定の分に実行する必要がある場合は cron を使ってください。
タイムゾーンと夏時間
EventBridge ルールは cron を UTC で評価し、AWS の例もすべて UTC+0 です。ニューヨーク時間の 09:00 に実行するには、UTC の時刻を自分で計算し、時計の切り替え時に変更する必要があります。
EventBridge Scheduler は、cron と 1 回限りのスケジュールを、スケジュールに指定したタイムゾーン(--schedule-expression-timezone、CloudFormation では ScheduleExpressionTimezone、IANA タイムゾーンデータベースの名前)で評価し、夏時間を考慮します:
- 時計が進むときは、存在しない 1 時間に当たる実行はその日スキップされます。
- 時計が戻るときは、2 回ある時刻は 2 回目に 1 回だけ実行されます。
rate(1 days)は 24 時間を意味するため、23 時間や 25 時間の日には時計に対して 1 時間ずれます。
ビルダーはこれらのルールに従い、スキップされる時刻や重複する時刻に印を付けます。Scheduler はターゲットを 60 秒の精度で呼び出します。1:00 の実行は、柔軟な時間枠を設定しない限り 1:00:00〜1:00:59 の間に行われます。
1 回限りのスケジュール:at()
EventBridge Scheduler は、指定した時刻にターゲットを 1 回だけ呼び出すこともできます:at(2026-12-31T23:30:00)(スケジュールのタイムゾーン)。EventBridge ルールはこれに対応していません。1 回限りのスケジュールは実行後もスケジュールのクォータに数えられるため、AWS は実行後に削除することを推奨しています。
出典
よくある質問
AWS で「Parameter ScheduleExpression is not valid」と表示されるのはなぜですか?
EventBridge は式全体をチェックし、どこかがルールに違反していればこの ValidationException で拒否します。よくある原因は、6 つではなく 5 つのフィールド、日と曜日の両方に *(一方は ? が必要)、日曜日を 0 と書く(AWS は日曜日から 1〜7 で数える)、曜日での / の増分、rate(1 minute) ではなく rate(1 minutes) と書くことです。上のビルダーに式を貼り付けると、どのフィールドが誤っているかわかります。
AWS cron は UTC ですか?
EventBridge のスケジュールされたルールでは、はい。式は常に UTC で評価されます。EventBridge Scheduler では、スケジュールごとにタイムゾーン(ScheduleExpressionTimezone、Asia/Tokyo などの任意の IANA 名)を設定でき、夏時間も考慮されます。指定しない場合は UTC です。
Lambda 関数を 5 分ごとに実行するには?
rate(5 minutes) または cron(0/5 * * * ? *) を使います。EventBridge Scheduler では、関数をターゲットとし、Scheduler が引き受けられるロールを指定してスケジュールを作成します。EventBridge ルールでは、関数をターゲットに追加し、aws lambda add-permission で EventBridge に呼び出しの権限を与えます。
AWS cron 式の ? は何を意味しますか?
「任意」です。AWS cron には日と曜日の別々のフィールドがあり、両方を制限することはできないため、使わない方を ? にする必要があります。たとえば cron(0 9 ? * MON *) は毎週月曜日、cron(0 9 1 * ? *) は毎月 1 日に実行されます。
EventBridge のスケジュールを 1 分に 2 回以上実行できますか?
いいえ。1 分未満の頻度になる cron 式はサポートされず、rate() で使える単位は分、時間、日です。また、EventBridge Scheduler はターゲットを 60 秒の精度で呼び出すため、1:00 のスケジュールは 1:00:00〜1:00:59 の間に実行されます。
ビルダーは式をどこかに送信しますか?
いいえ。解析と実行時刻の計算は、タイムゾーンの変換も含めてブラウザ内で行われ、変換にはブラウザ内蔵のタイムゾーンデータを使います。入力した内容はどこにも送信されず、このページは Cookie を使いません。
EventBridge、Lambda、CloudWatch のアラームとログには CloudConsole の専用画面があるので、どのアラームが発火したかを確認し、その実行のログをスマホで読めます。iPhone と Android に対応。
アプリについて →