Planification cron
Une planification « cron » est composée de six ou sept sous-champs qui décrivent quand les robots doivent être exécutés. Ces sous-champs sont séparés par un ou plusieurs espaces et représentent :
- Secondes
- Minutes
- Heures
- Jour du mois
- Mois
- Jour de la semaine
- Année (champ optionnel)
Un exemple de planification cron complète est « 0 0 12 ? * WED », ce qui signifie « tous les mercredis à 12h00 ».
Les sous-champs individuels peuvent contenir des plages et/ou des listes. Par exemple, le champ Jour de la semaine de l'exemple précédent (c'est-à-dire « WED ») pourrait être remplacé par « MON-FRI », « MON, WED, FRI » ou même « MON-WED, SAT ».
Des caractères génériques (le caractère « * ») peuvent également être utilisés, signifiant « chaque valeur possible de ce champ ». Par exemple, le caractère « * » dans le champ Mois de l'exemple précédent signifierait « tous les mois ». Le caractère « * » dans le champ Jour de la semaine signifierait « tous les jours de la semaine ».
L'ensemble des valeurs valides pour chaque champ est :
- Secondes : Les nombres de 0 à 59.
- Minutes : Les nombres de 0 à 59.
- Heures : Les nombres de 0 à 23.
- Jour du mois : Les nombres de 1 à 31 (prennent en compte tous les jours qu'un mois peut avoir).
- Mois : Les nombres 1 à 12, ou les chaînes JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV et DEC.
- Jour de la semaine : Le nombre 1 à 7 (1 est le dimanche), ou les chaînes SUN, MON, TUE, WED, THU, FRI et SAT.
- Année : N'importe quel nombre.
De plus, un certain nombre de caractères spéciaux peuvent être utilisés :
|
Définition |
|
|---|---|
|
/ |
Spécifie les incréments des valeurs. Par exemple, si vous insérez « 0/15 » dans le champ Minutes, cela signifie « toutes les 15 minutes, à partir de la minute zéro ». Si vous utilisez « 3/20 » dans le champ Minutes, cela signifie « toutes les 20 minutes pendant l'heure, à partir de la troisième minute ». En d'autres termes, cela revient à spécifier « 3, 23, 43 ». |
|
? |
Autorisé uniquement dans les champs Jour du mois et Jour de la semaine et signifie « aucune valeur spécifique ». Ceci est utile lorsque vous devez spécifier quelque chose dans l'un de ces deux champs, mais pas dans l'autre. Voir les exemples ci-dessous pour plus d'informations. |
|
L |
Autorisé uniquement dans les champs Jour du mois et Jour de la semaine. « L » est un raccourci pour « dernier », mais sa signification diffère entre les deux champs. Dans le champ Jour du mois, « L » signifie « le dernier jour du mois » – le 31 pour janvier, le 28 pour février les années non bissextiles, et ainsi de suite. S'il est utilisé seul dans le champ Jour de la semaine, cela signifie « 7 » ou « SAT », mais s'il est utilisé dans le champ Jour de la semaine après une autre valeur, cela signifie « le dernier xxx jour du mois ». Par exemple, « 6L » ou « FRIL » signifient tous deux « le dernier vendredi du mois ». Lorsque vous utilisez le caractère « L », il est important de ne pas spécifier de listes ou de plages de valeur, car vous obtiendrez des résultats confus. |
|
# |
Utilisé dans le champ Jour de la semaine pour spécifier « le nième » XXX jour de la semaine du mois. Par exemple, la valeur « 6#3 » ou « FRI#3 » signifie « le troisième vendredi du mois ». |
|
W |
Spécifie le jour de la semaine (du lundi au vendredi) le plus proche du jour donné. Par exemple, si « 15W » est spécifié comme valeur pour le champ Jour du mois, la signification est : « le jour de la semaine le plus proche du 15 du mois ». |
Exemples
|
Planification cron |
Explication |
|---|---|
|
0 0 12 * * ? |
Déclenchement à 12h00 (midi) tous les jours |
|
0 15 10 ? * * |
Déclenchement à 10h15 tous les jours |
|
0 15 10 * * ? |
Déclenchement à 10h15 tous les jours |
|
0 15 10 * * ? * |
Déclenchement à 10h15 tous les jours |
|
0 15 10 * * ? 2005 |
Déclenchement à 10h15 tous les jours pendant l'année 2005 |
|
0 * 14 * * ? |
Déclenchement toutes les minutes à partir de 14h00 et jusqu'à 14h59, tous les jours |
|
0 0/5 14 * * ? |
Déclenchement toutes les 5 minutes à partir de 14h00 et jusqu'à 14h55, tous les jours |
|
0 0/5 14,18 * * ? |
Déclenchement toutes les 5 minutes à partir de 14h00 et jusqu'à 14h55, ET déclenchement toutes les 5 minutes à partir de 18h00 et jusqu'à 18h55, tous les jours |
|
0 0-5 14 * * ? |
Déclenchement toutes les minutes à partir de 14h00 et jusqu'à 14h05, tous les jours |
|
0 10,44 14 ? 3 WED |
Déclenchement à 14h10 et à 14h44 tous les mercredis du mois de mars. |
|
0 15 10 ? * MON-FRI |
Déclenchement à 10h15 tous les lundis, mardis, mercredis, jeudis et vendredis |
|
0 15 10 15 * ? |
Déclenchement à 10h15 le 15e jour de chaque mois |
|
0 15 10 L * ? |
Déclenchement à 10h15 le dernier jour de chaque mois |
|
0 15 10 ? * 6L |
Déclenchement à 10h15 le dernier vendredi de chaque mois |
|
0 15 10 ? * 6L |
Déclenchement à 10h15 le dernier vendredi de chaque mois |
|
0 15 10 ? * 6L 2002-2005 |
Déclenchement à 10h15 le dernier vendredi de chaque mois pendant les années 2002, 2003, 2004 et 2005 |
|
0 15 10 ? * 6#3 |
Déclenchement à 10h15 le troisième vendredi de chaque mois |