Calculer les prochaines exécutions d'une expression cron

Une expression cron est une chaîne courte qui décrit une récurrence dans le temps. Le format hérité d'Unix tient en cinq champs séparés par des espaces : minute, heure, jour du mois, mois et jour de la semaine. Cette syntaxe est née avec le démon cron de Brian Kernighan dans les années 1970, puis généralisée par le Vixie cron (1987) repris par toutes les distributions Linux et macOS modernes. Aujourd'hui, la même syntaxe se retrouve dans la majorité des planificateurs cloud (AWS EventBridge, GCP Cloud Scheduler, Azure Logic Apps) et CI/CD (GitHub Actions, GitLab CI, Jenkins).

┌──── minute (0-59)
│ ┌── heure (0-23)
│ │ ┌── jour du mois (1-31)
│ │ │ ┌── mois (1-12 ou JAN-DEC)
│ │ │ │ ┌── jour de la semaine (0-7 ou SUN-SAT, 0 et 7 = dimanche)
│ │ │ │ │
* * * * *

Une expression cron bien formée définit donc un cron schedule précis : chaque champ peut être une valeur fixe, une plage, une liste, un pas ou un astérisque qui matche tout. La compacité de la crontab expression est sa force, mais c'est aussi ce qui rend un cron decoder indispensable pour valider visuellement l'intention. C'est tout l'objet de ce cron converter : produire une explication cron lisible, plus la liste des prochaines exécutions.

Les cinq champs partagent une grammaire commune. Voici les bornes acceptées par chaque colonne d'une expression crontab standard :

• Minute : 0-59.
• Heure : 0-23, format 24h.
• Jour du mois : 1-31.
• Mois : 1-12 ou les abréviations textuelles JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
• Jour de la semaine : 0-7 où 0 et 7 représentent tous deux dimanche, ou les abréviations SUN, MON, TUE, WED, THU, FRI, SAT.

Caractères spéciaux partagés par les cinq champs :

• * : any value, matche toutes les valeurs autorisées du champ.
• , : liste discrète, par exemple 1,15,30 dans le champ minute.
• - : plage inclusive, par exemple 9-17 pour les heures de bureau.
• / : pas (step), par exemple */15 = toutes les 15 unités, ou 0-30/5 = toutes les 5 minutes entre 0 et 30.

Extensions Quartz (Java, AWS EventBridge, Spring) : la grammaire grimpe à 6 ou 7 champs avec une colonne secondes en tête (0-59) et parfois une colonne année en queue (1970-2099). Quartz introduit aussi ? (no specific value, pour découpler jour-du-mois et jour-de-la-semaine), L (last : dernier jour du mois, ou dernier vendredi avec 5L), W (jour ouvré le plus proche) et # (N-ième jour de la semaine du mois, par exemple 2#3 pour le 3ème lundi). Une expression Quartz n'est en général pas compatible avec un crontab UNIX, et vice versa : c'est la principale source d'erreur quand on copie une cron expression d'une plateforme à l'autre.

# UNIX / Vixie cron (5 champs)
0 9 * * 1-5

# Quartz (6 champs avec secondes)
0 0 9 ? * MON-FRI

# Quartz (7 champs avec année)
0 0 9 ? * MON-FRI 2026

Lire 0 0 * * * est rapide. Lire */7 2-5 1,15 * 1-5 l'est nettement moins. Quand une expression sort du trivial, le risque d'erreur d'interprétation grimpe et la cron decode devient une étape de revue à part entière.

• Debug production : comprendre pourquoi une tâche s'est déclenchée à 03h17 et pas à 03h00, ou identifier un chevauchement entre deux jobs.
• Code review : valider qu'un planificateur poussé en pull request fait bien ce que l'auteur prétend, sans devoir mémoriser la sémantique de chaque symbole.
• Audit de planificateurs : passer en revue les cron jobs Linux dans /etc/crontab et /etc/cron.d/, les triggers Jenkins, les spec.schedule de Kubernetes CronJob, les règles AWS EventBridge et les jobs GCP Cloud Scheduler.
• Migration legacy : reprendre un /etc/crontab historique sans documentation et reconstruire la cartographie des tâches avant un changement d'infrastructure.
• Onboarding : permettre à un nouveau développeur de relire une crontab sans avoir à apprendre tous les caractères spéciaux du jour au lendemain.

La marche à suivre pour décoder une expression crontab avec l'outil :

1. Collez votre cron expression dans le champ de saisie (5 champs séparés par des espaces).
2. Indiquez le nombre de prochaines exécutions à calculer.
3. Cliquez sur convert pour lancer le cron decode : l'outil renvoie une phrase humaine qui explique le déclenchement, plus la liste datée des prochaines exécutions.
4. Vérifiez visuellement que les dates correspondent à votre intention (heure, jour, fréquence).
5. Copiez la sortie via le bouton de copie pour la coller dans un ticket, une PR ou une documentation technique.

L'outil ne se contente pas d'un parsing syntaxique : il fournit une explication cron en langage naturel, ce qui en fait à la fois un cron decoder et un valideur de planning.

Les motifs ci-dessous couvrent l'essentiel des cron schedules rencontrés en production. Ils sont tous valides sur Linux crontab, Kubernetes CronJob, GitHub Actions et la majorité des planificateurs applicatifs.

Pour exécuter une tâche cron sur un serveur Linux, on édite la crontab utilisateur depuis le shell :

# éditer la crontab de l'utilisateur courant
$ crontab -e

# lister les tâches existantes
$ crontab -l

# exemple de ligne ajoutée : sauvegarde quotidienne à 3h
0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1

Exemple de sortie du cron converter pour */5 * * * * :

2026-05-05 00:00:00
2026-05-05 00:05:00
2026-05-05 00:10:00
2026-05-05 00:15:00
2026-05-05 00:20:00
...