Intervalle d'expression CRON

Une expression CRON sert à configurer des instances spécifiques d'un déclencheur. Elle est principalement utilisée pour des déclenchements répétitifs planifiés. Il s'agit d'une chaîne composée de 6 ou 7 champs qui représentent les valeurs distinctes de la planification. Ces champs sont séparés par un espace. Ils contiennent les valeurs autorisées dans des combinaisons variées.

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

Voici la liste des valeurs que vous pouvez utiliser dans une 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 est identique à SUN)

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

│  │  │  │  │  │  │

*  *  *  *  *  ?  *

0 0 0 signifie minuit (secondes, minutes, heures).

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

Le caractère * signifie toutes les/tous les (secondes, minutes, heures, jour du mois, mois, jour de la semaine, année).

SUN signifie le dimanche.


note

Le nom des mois et des jours de la semaine ne respecte pas la casse. Par exemple, MON équivaut à mon ou JAN équivaut à jan.

Caractères spéciaux :

Virgule (,)

Les virgules servent à séparer des éléments dans une liste. Par exemple, l'utilisation de MON,WED,FRI dans le sixième champ (jour de la semaine) signifie les lundis, mercredis et vendredis.

Tiret (-)

Définit des plages. Par exemple, 2012-2020 signifie chaque année entre 2012 et 2020, inclusif.

Caractère générique(*)

Utilisé pour sélectionner toutes les valeurs possibles dans un champ. Par exemple, le caractère générique * dans le champ des minutes signifie toutes les minutes. Le caractère générique * ne peut pas être utilisé dans le champ des jours de la semaine.

Point d'interrogation(?)

Lorsque vous sélectionnez un jour spécifique, vous pouvez indiquer un jour du mois ou un jour de la semaine. Vous ne pouvez pas spécifier les deux. Si vous indiquez un jour du mois, vous devez utiliser le caractère ? pour le jour de la semaine, et inversement. Par exemple, si vous souhaitez que le déclencheur soit déclenché un jour du mois spécifique (le 10, par exemple) et si le jour de la semaine vous importe peu, indiquez 10 dans le champ des jours du mois et placez le caractère ? dans le champ des jours de la semaine.

Dièse (#)

Utilisé pour spécifier le « énième » jour du mois. Par exemple, la valeur 4#3 dans le champ des jours de la semaine signifie le troisième jeudi du mois (jour 4 = jeudi et #3 = le troisième jeudi du mois). Si vous spécifiez #5 et s'il n'existe pas de 5ème jour donné de la semaine dans le mois, le déclencheur ne se déclenche pas ce mois.

Barre oblique (/)

Décrit les incréments d'une plage. Par exemple, la valeur 3-59/15 dans le deuxième champ (minutes) indique la troisième minute de l'heure et toutes les 15 minutes par la suite.

Dernier (Last) (L)

Lorsque le caractère L est utilisé dans le champ des jours de la semaine, il permet de spécifier des constructions comme 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é dans le champ des jours du mois. Ce caractère sert à spécifier le jour (lundi à vendredi) le plus proche de la date donnée. Par exemple, si vous indiquez 15W comme valeur dans le champ des jours du mois, vous spécifiez le jour le plus proche du 15 du mois. Si le 15 du mois correspond à un samedi, le déclencheur se déclenche le vendredi 14. Si le 15 correspond à un dimanche, le déclencheur se déclenche le lundi 16. Toutefois, si vous spécifiez 1W comme valeur du champ des jours du mois et si le 1er jour du mois correspond à un samedi, le déclencheur se déclenche le lundi 3, car il ne dépasse pas la limite des jours d'un mois.


note

Les caractères L et W peuvent être également combinés dans le champ des jours du mois pour donner LW, c'est-à-dire le dernier jour de la semaine du mois.

Aléatoire (Random) (R)

Le caractère R est un caractère d'expression CRON ESET PROTECT spécial qui permet de spécifier des moments aléatoires. Par exemple, le déclencheur R 0 0 * * ? * se déclenche tous les jours à 00:00 et des secondes aléatoires (0 à 59).


important

Il est recommandé d'utiliser des moments aléatoires pour empêcher la connexion simultanée de tous les ESET Management Agent à ESET PROTECT Server.

Voici des exemples réels qui illustrent quelques variantes des expressions CRON :

Expression CRON

Signification

0 0 12 * * ? *

Déclenchement à 12:00 (midi) tous les jours.

R 0 0 * * ? *

Déclenchement à 00:00 et des secondes aléatoires (0 à 59) tous les jours.

R R R 15W * ? *

Déclenchement le 15 de chaque mois à une heure aléatoire (secondes, minutes, heures). Si le 15 d'un mois correspond à un samedi, le déclencheur se déclenche le vendredi 14. Si le 15 correspond à un dimanche, le déclencheur se déclenche le lundi 16.

0 15 10 * * ? 2016

Déclenchement à 10:15 tous les jours pendant l'année 2016.

0 * 14 * * ? *

Déclenchement toutes les minutes à partir de 14:00 et jusqu'à 14:59 tous les jours.

0 0/5 14 * * ? *

Déclenchement toutes les 5 minutes à partir de 14:00 et jusqu'à 14:55 tous les jours.

0 0/5 14,18 * * ? *

Déclenchement toutes les 5 minutes à partir de 14:00 jusqu'à 14:55 et déclenchement toutes les 5 minutes à partir de 18:00 et jusqu'à 18:55 tous les jours.

0 0-5 14 * * ? *

Déclenchement toutes les minutes à partir de 14:00 et jusqu'à 14:59 tous les jours.

0 10,44 14 ? 3 WED *

Déclenchement à 14:10 et 14:44 tous les mercredis du mois de mars.

0 15 10 ? * MON-FRI *

Déclenchement à 10:15 tous les jours de la semaine (lundi, mardi, mercredi, jeudi et vendredi).

0 15 10 15 * ? *

Déclenchement à 10:15 le 15ème jour de tous les mois.

0 15 10 ? * 5L *

Déclenchement à 10:15 le dernier vendredi de tous les mois.

0 15 10 ? * 5L 2016-2020

Déclenchement à 10:15 tous les derniers vendredis de chaque mois de l'année 2016 à l'année 2020, inclusif.

0 15 10 ? * 5#3 *

Déclenchement à 10:15 le 3ème vendredi de tous les mois.

0 0 * * * ? *

Déclenchement toutes les heures, tous les jours.