時間式(Cron式)の設定方法
この記事の内容
Cron式は、定期タスクの実行時刻を定義する文字列式です。Dr.Roboの定時トリガーや定期タスクのスケジュール設定に使用できます。たとえば、文字列 0 12 * 5 3 は、5月の毎週水曜日12:00にトリガーすることを表します。
基本形式と意味
Cron式は、" 0 12 * 6 * "のような文字列で、スペースで区切られた5つの部分式から構成されます。左から順に、分、時間、日付(月の何日目か)、月、曜日(週の何日目か)を表します。
部分式の値には、範囲またはリストを指定できます。たとえば、【曜日】フィールドには、" 0 - 3 "【日曜日から水曜日を表します】、" 0, 2, 4 "【日曜日、火曜日、木曜日を表します】、または" 1-3, 5 "【月曜日から水曜日と金曜日を表します】を指定できます。
すべての部分式には、それぞれ指定可能な値の範囲があります。以下のとおりです。
| 部分式のフィールド | 説明 | 指定可能な値 | 使用可能な特殊文字 |
|---|---|---|---|
| 分フィールド | 1時間の何分目かを表します | 0 - 59 | - * / , |
| 時間フィールド | 1日の何時かを表します | 0 - 23 | - * / , |
| 日付フィールド | 1か月の何日目かを表します | 1 - 31 | - * / , |
| 月フィールド | 1年の何月かを表します | 1 - 12または JAN - DEC | - * / , |
| 曜日フィールド | 1週間の何日目かを表します | 0 - 6【曜日は日曜日から数えます。数字の0は日曜日、数字の1は月曜日を表し、以降も同様です】 | - * / , |
ヒント:日付と曜日の両方に、具体的な値を同時に指定することはできません。一方に具体的な値を設定した場合、もう一方は*に設定する必要があります。
主なワイルドカードと使い方
- [-] 文字が表すもの —— 値の範囲です。時間フィールドの10-12は、10時、11時、12時を表します。
- [ * ] 文字が表すもの —— 任意の値です。分フィールドの「 * 」は、毎分を表します。
- [ / ] 文字が表すもの —— 一連の値です。右側の数値は、左側の基準値からの増加値です。分フィールドの「 0 / 15 」は、0分、15分、30分、45分を表し、分フィールドの「 5 / 15 」は、5分、20分、35分、50分を表します。
- [ , ] 文字が表すもの —— リストの項目の区切りです。日付フィールドの「 1, 3, 5 」は、指定した月の1日、3日、5日を表します。
代表的な例
| 式 | 意味 |
|---|---|
* * * * * |
毎日、毎時間、1分間隔でスケジュールタスクを1回実行します |
0 * * * * |
毎日、毎正時にスケジュールタスクを1回実行します |
15 10 * * * |
毎日10:15にスケジュールタスクを1回実行します |
5 12 1 * * |
毎月1日の12:05にスケジュールタスクを1回実行します |
10 15 20 3 * |
毎年3月20日の15:10にスケジュールタスクを1回実行します |
10 15 * 3 0 |
毎年3月の毎週日曜日15:10にスケジュールタスクを1回実行します |
* 14 * * * |
毎日14:00から14:59まで、1分間隔で1回トリガーします |
0/5 14 * * * |
毎日14:00から14:59まで、5分間隔で1回トリガーします |
0/5 14,18 * * * |
毎日14:00から14:59までと18:00から18:59まで、5分間隔で1回トリガーします |
0-5 14 * * * |
毎日14:00から14:05まで、1分間隔で1回トリガーします |
10,44 14 * 3 WED |
3月の毎週水曜日14:10と14:44に、それぞれ1回トリガーします |
0 0 1 * * |
毎月1日の0時に1回トリガーします |