時間式(Cron式)の設定方法

この記事の内容
  1. 基本形式と意味
  2. 主なワイルドカードと使い方
  3. 代表的な例

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回トリガーします
よくある質問の記事一覧ページの先頭へ ↑