Analyseur Cron

Lire une expression cron

Une expression cron comporte cinq champs séparés par des espaces, lus de gauche à droite : minute, heure, jour du mois, mois, jour de la semaine. Presque toutes les erreurs de cron viennent d'un champ mal placé ou d'une incompréhension de l'interaction entre les deux champs de jour.

Comment ça marche

• Analyse les cinq champs, décrit chacun en mots, puis liste les prochaines exécutions.
• Gère les opérateurs standard : * pour toute valeur, */n pour un sur n, a-b pour les plages et a,b,c pour les listes.
• Interprète l'expression dans le fuseau de votre navigateur, qui n'est pas forcément celui de votre serveur.

┌───────── minute         (0–59)
│ ┌─────── heure          (0–23)
│ │ ┌───── jour du mois   (1–31)
│ │ │ ┌─── mois           (1–12)
│ │ │ │ ┌─ jour de semaine (0–6, dimanche = 0)
│ │ │ │ │
* * * * *

Exemple chiffré

Décodage de 30 2 * * 1-5 — un planning qui piège à cause des deux champs de jour.

1. minute = 30
2. heure = 2
3. jour du mois = * (tous les jours)
4. mois = * (tous les mois)
5. jour de la semaine = 1-5 (du lundi au vendredi)

S'exécute à 02:30 chaque jour ouvré. Notez que le jour du mois vaut ici * : s'il avait porté un nombre précis, cron se serait déclenché dès que l'un des deux champs de jour correspondait, pas les deux. C'est la surprise cron la plus répandue.

Lire le résultat

• Quand jour du mois et jour de la semaine sont tous deux restreints, cron applique un OU, pas un ET. 0 0 1 * 1 s'exécute le 1er du mois ET tous les lundis, pas seulement les lundis tombant un 1er.
• Cron utilise le fuseau du serveur sauf configuration contraire, et la plupart des crontabs gèrent mal le changement d'heure. Une tâche prévue à 02:30 peut s'exécuter deux fois ou pas du tout la nuit du changement.
• Il n'existe pas de « toutes les 90 minutes ». Les pas divisent le champ, donc */90 dans le champ des minutes est invalide ; écrivez deux entrées ou déplacez la logique d'intervalle dans la tâche.
• Certaines implémentations ajoutent un sixième champ de secondes en tête, et Quartz en utilise sept avec l'année. Vérifiez le dialecte de votre ordonnanceur avant de copier une expression trouvée ailleurs.

Questions fréquentes

Pourquoi ma tâche s'exécute-t-elle plus souvent que prévu ?

En général à cause du OU entre jour du mois et jour de la semaine, ou d'un pas appliqué au mauvais champ. Relire l'expression en mots, comme le fait cet outil, révèle vite les deux cas.

Comment planifier au dernier jour du mois ?

Cron standard ne sait pas l'exprimer. L'astuce habituelle : exécuter tous les jours et faire sortir la tâche immédiatement si demain n'est pas le 1er. Certains dialectes ajoutent un caractère L pour cela.

Sources

• POSIX.1-2017 — crontab