Explicateur d'Expressions Cron

Qu'est-ce que cron ?

Cron est le planificateur intégré à Linux et macOS, et sa syntaxe a été reprise par GitHub Actions, GitLab CI, Kubernetes, les planificateurs cloud et de nombreuses bibliothèques. Chaque planification est une ligne de cinq champs séparés par des espaces. Quand l'heure actuelle correspond aux cinq champs, la tâche s'exécute.

Les cinq champs

• Minute : 0 à 59
• Heure : 0 à 23, au format 24 heures
• Jour du mois : 1 à 31
• Mois : 1 à 12, ou JAN à DEC
• Jour de la semaine : 0 à 7, ou SUN à SAT. 0 et 7 désignent tous deux le dimanche

Caractères spéciaux

• * (tout) : Toutes les valeurs. * dans le champ heure signifie toutes les heures
• , (liste) : Plusieurs valeurs. 0,30 signifie la minute 0 et la minute 30
• - (plage) : Un intervalle. 1-5 dans le jour de la semaine signifie du lundi au vendredi
• / (pas) : Une valeur sur n. */10 signifie toutes les 10 minutes, et 9-17/2 signifie 9, 11, 13, 15 et 17
• Macros : @hourly, @daily, @weekly, @monthly et @yearly sont des raccourcis, et @reboot s'exécute une fois au démarrage

Comment utiliser l'explicateur

Étape 1 : Saisissez une expression

Tapez ou collez votre expression cron, ou cliquez sur l'un des exemples. Le résumé se met à jour pendant la saisie.

Étape 2 : Vérifiez chaque champ

Le tableau Field by field indique le sens de chaque partie et développe les plages et les pas en valeurs réelles : vous voyez ainsi que */15 correspond aux minutes 0, 15, 30 et 45.

Étape 3 : Consultez les prochaines exécutions

La liste Next runs affiche les prochaines exécutions et le délai avant chacune. Basculez entre l'heure locale et UTC, car la plupart des serveurs et des systèmes de CI exécutent cron en UTC. Affichez 5, 10 ou 20 exécutions.

Étape 4 : Partagez-la

L'adresse de la page se met à jour avec votre expression : copiez le lien dans une pull request ou une discussion, et les autres verront la même explication.

Planifications cron courantes

• * * * * * : toutes les minutes
• */5 * * * * : toutes les 5 minutes
• 0 * * * * : au début de chaque heure
• 0 0 * * * : tous les jours à minuit
• 30 9 * * 1-5 : en semaine à 9 h 30
• 0 0 * * 0 : tous les dimanches à minuit
• 0 0 1 * * : le premier jour de chaque mois
• 0 0 1 1,4,7,10 * : le premier jour de chaque trimestre

Le piège du jour de la semaine

Quand le jour du mois et le jour de la semaine sont tous deux restreints, cron lance la tâche si l'un ou l'autre correspond, pas les deux. Ainsi, 0 0 1 * 1 s'exécute le 1er de chaque mois et tous les lundis. L'explicateur écrit « or » dans ces cas pour que la surprise n'arrive pas en production. Si l'un des deux champs commence par *, comme */2, les deux doivent correspondre.

Autres points d'attention

• Fuseaux horaires : Cron utilise le fuseau du serveur, souvent UTC. Comparez les deux vues avant de vous fier à une heure
• Heure d'été : Une heure qui n'existe pas le jour du passage à l'heure d'été est ignorée dans la liste. La plupart des démons cron exécutent ces tâches juste après le changement
• Dates impossibles : 0 0 30 2 * ne s'exécute jamais. L'explicateur vous prévient quand une planification n'a aucune exécution dans les 5 prochaines années
• Champ des secondes : Quartz et Spring ajoutent un champ de secondes et des caractères comme ?, L et #. Cet outil suit le cron standard à 5 champs et signale les expressions dans l'autre format

Confidentialité

Tout est calculé dans votre navigateur. Vos planifications ne sont envoyées nulle part, sauf dans l'adresse de la page si vous choisissez de la partager.

Conclusion

Un résumé clair, le détail des champs et les vraies prochaines exécutions suppriment les approximations avec cron. Vérifiez votre prochaine planification sur tools.typinks.com/cron-explainer.