フィルターへの配信登録用の cron 式の作成
このページでは、cron 式の作成方法について説明します。「検索結果での作業」ページにあるように、cron 式は、フィルターへの配信登録を行う際に使用できます。
cron 式を使用することで、既定のスケジュールよりも詳細に頻度を制御できます。例えば、毎月第 2 金曜日の午後 8:15 に通知を行う cron 式を定義できます。
cron 式の作成
cron 式は、スペースで区切られた複数の文字列フィールドです。次の表は cron 式の各フィールドす。この並び順で、左から右に指定する必要があります。
| 秒 | 分 | 時間 | 日 | Month | 曜日 | 年 (任意) | |
|---|---|---|---|---|---|---|---|
| 指定可能な値 | 0-59 | 0-59 | 0-23 | 1-31 | 1-12 or JAN-DEC | 1-7 or SUN-SAT | 1970-2099 |
| 許可される特殊文字 | , - * / | , - * / | , - * / | , - * / ? L W | , - * / | , - * / ? L # | , - * / |
cron 式では 大文字 / 小文字を区別しません。
次のような例があります。
0 15 8 ? JAN MON 2014これを直訳すると、0 秒、15 分、8 時、月の任意の日付、1 月、月曜日、2014 年となります。
通常の表記に置き換えると、2014 年 1 月のすべての月曜日の午前 8:15 となります。? 文字は "特定の値を持たない" という意味です。この例では、月の日付を設定していません。曜日を設定してるため、日付を指定する必要はありません。特殊文字については、次のセクションで説明します。
cron 式のその他の例については、このページの下部にある「例」セクションをご参照ください。
特殊文字
特殊文字 | 用途 |
|---|---|
, | 値の一覧を指定します。たとえば、曜日フィールドでは、「MON,WED,FRI」は「毎週月、水、金曜日」を意味します。 |
- | 値の範囲を指定します。たとえば、曜日フィールドでは、「MON-FRI」は「毎週月、火、水、木、金曜日」を意味します。 |
* | とりうるすべての値を指定します。たとえば、時間フィールドでは、「*」は「その日の毎時」を意味します。 |
/ | 与えられた値に対する増分を指定します。例えば、分フィールドでは、「0/15」 は「その 1 時間の間で、0 分から開始した場合の 15 分間隔」を意味します。 |
? | 特定の値を指定しません。月 または 曜日の 2 つのフィールドで、一方は値の指定が必要だが、他方は必要でない場合に便利です。 |
L | Specifies the last possible value; this has different meanings depending on context. In the Day-of-week field, 'L' on its own means 'the last day of every week' (i.e. 'every Saturday'), or if used after another value, means 'the last xxx day of the month' (e.g. '7L' will mean 'the last Saturday of the month'). In the Day-of-month field, 'L' on its own means 'the last day of the month', or 'LW' means 'the last weekday of the month'. |
W | 月の特定の日に最も近い平日 (月曜日 〜 金曜日) を指定します。たとえば、 「1W」 は「その月の 1 日に最も近い平日」を意味します (1 日が土曜日の場合、メールは同月内の 最も近い平日、すなわち 3 日月曜日に送信されます)。「W」は、日の値として、範囲や一覧ではなく単一の日を指定している場合にのみ利用できます。 |
# | 特定の第 n 曜日を指定します。たとえば、「TUES#2」 (または「3#2」) は、「その月の第 2 火曜日」を意味します。 |
例
| 毎日午後 8 時 15 分。 |
| 毎日午前 8 時 15 分。 |
| 毎日午後 2 時 00 分から午後 2 時 59 分までの 1 分間隔。 |
| 毎日午後 2 時 00 分から午後 2 時 55 分までの 5 分間隔。 |
| 毎日午後 2 時 00 分から午後 2 時 55 分までの 5 分間隔、および毎日午後 6 時 00 分から午後 6 時 55 分までの 5 分間隔。 |
| 毎日午後 2 時 00 分から午後 2 時 05 分までの 1 分間隔。 |
| 期間指定なしの (永久に続く) 10 分間隔。 |
0 30 07 ? * 3,5 | 7:30 am every Tuesday and Thursday |
| 3 月の毎週水曜日の午後 2 時 10 分および午後 2 時 44 分。 |
| 毎週月、火、水、木、金曜日の午前 8 時 15 分。 |
| 毎月 15 日の午前 8 時 15 分。 |
| 毎月最終日の午前 8 時 15 分。 |
| 毎月最後の平日の午前 8 時 15 分。 |
| 毎月最後の金曜日の午前 8 時 15 分。 |
| 毎月第 2 金曜日の午前 8 時 15 分。 |
| 2007 年、 2008 年、2009 年の毎月第 2 金曜日の午前 8 時 15 分。 |
0 0 1 1,15 * * | 1:00 am on the 1st and 15th day of every month. |