Intervalle d'expression CRON

Une expression CRON est employée pour configurer les instances particulières d'un déclencheur. La plupart du temps elle est utilisée pour un déclenchement répétitif prévu. Il s'agit d'une chaîne composée de 6 ou 7 champs qui représentent les valeurs individuelles du calendrier. Ces champs sont séparés par un espace et peuvent contenir n'importe laquelle des valeurs permises sous diverses combinaisons.

Une expression CRON peut être aussi simple que : * * * * ? * ou plus complexe comme : 0/5 14,18,3-39,52 * ? JAN,MAR,SEP MON-FRI 2012-2020

Liste des valeurs que vous pouvez utiliser dans l'expression CRON :

Nom

Requis

Valeur

Caractères spéciaux autorisés

Secondes

Oui

0-59

, - * / R

Minutes

Oui

0-59

, - * / R

Heures

Oui

0-23

, - * / R

Jour du mois

Oui

1-31

, - * / ? L W

Mois

Oui

1-12 ou JAN-DEC

, - */

Jour de la semaine

Oui

0-6 ou SUN-SAT

, - / ? L #

Année

Oui

1970-2099

, - * /

La syntaxe d'une expression CRON est la suivante :

 

┌────────── Secondes (0 à 59)

│ ┌────────── Minutes (0 à 59)

│ │ ┌────────── Heures (0 à 23)

│ │ │ ┌────────── Jour du mois (1 à 31)

│ │ │ │ ┌────────── Mois (1 à 12 ou JAN-DEC)

│ │ │ ┌────────── Jour de la semaine (0 à 6 ou SUN-SAT)(par exemple, 0 correspond aussi à SUN)

│ │ │ │ │ │ ┌────────── Année

│ │ │ │ │ │ │

* * * * * ? *

0 0 0 veut dire minuit (secondes, minutes, heures).

Utilisez le symbole ? lorsqu'une valeur ne peut pas être définie parce qu'elle a été définie dans un autre champ (jour du mois ou jour de la semaine).

Le symbole * désigne chaque (seconde, minute, heure, jour du mois, mois, jour de la semaine, année).

SUN veut dire dimanche.

icon_details_hoverREMARQUE

Les noms des mois et des jours de la semaine ne sont pas sensibles à la casse. Par exemple, MON est égal à mon, ou JAN est égal à jan.

Caractères spéciaux :

Virgule (,)

Les virgules sont utilisées pour séparer les éléments d'une liste. Par exemple, l'utilisation de « MON,WED,FRI » dans le sixième champ (jour de la semaine) veut dire les lundis, les mercredis et les vendredis.

Trait d'union (-)

permet de définir les plages. Par exemple, 2012-2020 indique chaque année entre 2012 et 2020 inclusivement.

Caractère générique (*)

Permet de sélectionner toutes les valeurs possibles dans un champ. Par exemple, * dans le champ minute signifie chaque minute. Le caractère générique ne peut pas être utilisé dans le champ jour de la semaine.

Point d'interrogation (?)

Lors du choix d'un jour précis, vous pouvez spécifier le jour du mois ou le jour de la semaine. Vous ne pouvez pas spécifier les deux. Si vous spécifiez jour du mois, vous devez utiliser ? pour le jour de la semaine, et vice versa. Par exemple, si vous voulez que le déclencheur soit activé un jour en particulier du mois (par exemple, le 10), mais que le jour de la semaine ne soit pas important, mettez 10 dans le champ Jour du mois et ? dans le champ Jour de la semaine.

Carré (dièse) (#)

Utilisé pour indiquer le « nième » jour du mois. Par exemple, la valeur de 4#3 dans le champ Jour de la semaine signifie le troisième jeudi du mois (4e jour = jeudi et #3 = le 3e jeudi du mois). Si vous indiquez #5 et que le jour de la semaine qu'il accompagne n'apparait pas 5 fois dans le mois, alors le déclencheur ne sera pas activé ce mois là.

Barre oblique (/)

Sert à décrire les incréments d'une plage. Par exemple 3-59/15 dans le 2e champ (minutes) indiquent la troisième minute de l'heure et toutes les 15 minutes par la suite.

Dernier (Last) (L)

Lorsque ce caractère est utilisé dans le champ Jour de la semaine, il vous permet d'effectuer des constructions telles que le dernier vendredi (5L) d'un mois donné. Dans le champ Jour du mois, il indique le dernier jour du mois. Par exemple, le 31 pour janvier, le 28 pour février pour les années non bissextiles.

Jour de la semaine (Weekday) (W)

Le caractère W est autorisé pour le champ Jour du mois. Ce caractère est utilisé pour spécifier le jour de la semaine (du lundi au vendredi) le plus proche du jour donné. A titre d'exemple, si vous spécifiez 15W comme valeur du champ Jour du mois, cela veut dire le jour de la semaine le plus proche du 15 du mois. Donc, si le 15 est un samedi, le déclencheur sera activé le vendredi 14. Si le 15 est un dimanche, le déclencheur sera activé le lundi 16. Toutefois, si vous spécifiez 1W comme valeur du jour du mois et que le 1er est un samedi, le déclencheur sera activé le lundi 3, car la limite des jours d'un mois ne peut être ignorée.

icon_details_hoverREMARQUE

Les caractères L et W peuvent également être combinés dans le champ Jour du mois pour donner LW, ce qui veut dire la dernière semaine du mois.

Aléatoire - (R)

R est un caractère spécial pour expression CRON propre à ERA qui vous permet de spécifier des moments aléatoires. Par exemple, R 0 0 * * ? * le déclencheur est activé tous les jours à 0 h 0, mais à une seconde aléatoire (0 à 59).

validation-status-icon-warning IMPORTANT

Il est recommandé d'utiliser les moments aléatoires pour empêcher tous les agents ERA de se connecter au serveur ERA au même moment.

Des exemples concrets qui illustrent quelques variations de l'expression CRON :

Expression CRON

Signification

0 0 12 * * ? *

Déclencher à 12 h (midi) tous les jours.

R 0 0 * * ? *

Déclencher à 0 h 0, mais à une seconde aléatoire (0 à 59).

R R R 15W * ? *

Déclencher le 15 de chaque mois à une heure aléatoire (secondes, minutes, heures). Si le 15 est un samedi, le déclenchement aura lieu le vendredi 14. Si le 15 est un dimanche, le déclencheur sera activé le lundi 16.

0 15 10 * * ? 2016

Déclencher à 10 h 15 tous les jours en 2016.

0 * 14 * * ? *

Déclencher toutes les minutes à partir de 14 h jusqu'à 14 h 59, tous les jours.

0 0/5 14 * * ? *

Déclencher toutes les 5 minutes à partir de 14 h jusqu'à 14 h 55, tous les jours.

0 0/5 14,18 * * ? *

Déclencher toutes les 5 minutes à partir de 14 h jusqu'à 14 h 55, et déclencher toutes les 5 minutes à partir de 18 h jusqu'à 18 h 5, tous les jours.

0 0-5 14 * * ? *

Déclencher toutes les minutes à partir de 14 h jusqu'à 14 h 05, tous les jours.

0 10,44 14 ? 3 WED *

Déclencher à 14 h 10 et à 14 h 44 tous les mercredis du mois de mars.

0 15 10 ? * MON-FRI *

Déclencher à 10 h 15 tous les lundis, mardis, mercredi, jeudis et vendredis.

0 15 10 15 * ? *

Déclencher à 10 h15 le 15e jour de chaque mois.

0 15 10 ? * 5L *

Déclencher à 10 h15 le dernier vendredi de chaque mois.

0 15 10 ? * 5L 2016-2020

Déclencher à 10 h 15 le dernier vendredi de chaque mois de 2016 à 2020 inclusivement.

0 15 10 ? * 5#3 *

Déclencher à 10 h15 le troisième vendredi de chaque mois.