GameParticles
Développeur

Aide-mémoire des expressions cron, avec des exemples concrets

La syntaxe cron en une page : cinq champs, quatre opérateurs, planifications prêtes à copier, et les pièges (logique OU des jours, heure d'été, variantes).

Mis à jour

Une expression cron se compose de cinq champs séparés par des espaces : minute, heure, jour du mois, mois, jour de la semaine. 0 9 * * 1-5 signifie 09:00 du lundi au vendredi. * désigne toutes les valeurs, , énumère des valeurs, - donne une plage et / définit un pas. Voilà l'essentiel de la syntaxe ; le reste de cette page est fait d'exemples et de pièges.

Les cinq champs

Dans l'ordre, avec leurs plages autorisées :

  1. Minute : 0-59
  2. Heure : 0-23 (format 24 heures)
  3. Jour du mois : 1-31
  4. Mois : 1-12 ou JAN-DEC
  5. Jour de la semaine : 0-6 où 0 est le dimanche (7 désigne aussi le dimanche sur la plupart des systèmes), ou SUN-SAT

L'expression se déclenche lorsque l'heure courante correspond à tous les champs, à une exception près, traitée plus bas. Les heures sont évaluées dans le fuseau horaire de la machine ou du service qui exécute le planificateur, généralement UTC sur les serveurs et dans les conteneurs.

Opérateurs

  • * toute valeur. * * * * * signifie chaque minute.
  • , liste. 0 9,17 * * * signifie 09:00 et 17:00.
  • - plage. 0 9-17 * * * signifie le début de chaque heure de 09:00 à 17:00 inclus, soit neuf exécutions.
  • / pas. */15 * * * * signifie toutes les 15 minutes : :00, :15, :30, :45. 0 */6 * * * signifie toutes les six heures. Un pas peut partir d'un décalage : 5/15 dans le champ des minutes signifie :05, :20, :35, :50.

Les opérateurs se combinent : 0 8-18/2 * * 1-5 signifie toutes les deux heures de 08:00 à 18:00, du lundi au vendredi.

Exemples concrets

  • * * * * * chaque minute
  • */5 * * * * toutes les 5 minutes
  • 0 * * * * toutes les heures, à l'heure pile
  • 30 * * * * toutes les heures à :30
  • 0 0 * * * tous les jours à minuit
  • 0 3 * * * tous les jours à 03:00, le créneau classique des sauvegardes
  • 0 9 * * 1-5 du lundi au vendredi à 09:00
  • 0 0 * * 0 chaque semaine, le dimanche à minuit
  • 0 0 * * 1 chaque semaine, le lundi à minuit
  • 0 0 1 * * le premier jour de chaque mois à minuit
  • 0 0 1 1 * une fois par an, le 1er janvier
  • 0 0 1 */3 * chaque trimestre : 1er janvier, 1er avril, 1er juillet, 1er octobre
  • 0 9,13,17 * * * trois fois par jour
  • 0 22 * * 1-5 les soirs de semaine à 22:00
  • 0 0 * * 6,0 le samedi et le dimanche à minuit
  • 15 2 * * * tous les jours à 02:15, décalé par rapport à l'heure pile
  • 0 0 */2 * * un jour sur deux, à peu près ; le pas repart du 1er, si bien qu'un mois de 31 jours se termine par deux exécutions consécutives

Écrire l'une de ces expressions à la main est facile. C'est pour vérifier qu'elle fait bien ce que vous vouliez que le générateur d'expressions cron est utile : il transforme n'importe quelle expression en une phrase en langage courant et liste les cinq prochaines exécutions.

Les pièges

Jour du mois et jour de la semaine : un OU, pas un ET

C'est la règle la plus surprenante de cron. Si les deux champs de jour sont restreints, la tâche s'exécute dès que l'un des deux correspond. 0 0 13 * 5 s'exécute le 13 de chaque mois et tous les vendredis, et pas seulement le vendredi 13. Il n'existe pas de syntaxe cron standard pour « le 13 uniquement si c'est un vendredi » ; faites cette vérification dans le script.

Dernier jour du mois

Le cron standard n'a pas de L. 0 0 28-31 * * se déclenche jusqu'à quatre fois. Le contournement habituel consiste à lancer la tâche tous les jours et à laisser le script vérifier si date -d tomorrow +%d vaut 01. Quartz (Java) et certains planificateurs cloud étendent la syntaxe avec L, W et #, mais ces expressions ne fonctionneront pas dans une crontab Linux.

Heure d'été

Une tâche à 0 2 * * * dans un fuseau horaire soumis à l'heure d'été sera ignorée la nuit du passage à l'heure d'été et exécutée deux fois la nuit du retour à l'heure d'hiver. Planifiez vos serveurs en UTC, ou choisissez des heures qui ne tombent jamais dans la fenêtre de transition.

Variantes non standard

  • La crontab Linux accepte @hourly, @daily, @weekly, @monthly, @yearly et @reboot.
  • Quartz, Spring et certains services AWS utilisent six ou sept champs, en ajoutant les secondes au début et une année facultative à la fin. 0 0 9 * * ? signifie, pour Quartz, tous les jours à 09:00 ; le ? veut dire « pas de valeur précise » et il est obligatoire dans l'un des deux champs de jour.
  • GitHub Actions et les CronJobs Kubernetes utilisent les cinq champs standard en UTC. GitHub précise aussi dans sa documentation que l'intervalle minimal autorisé est de cinq minutes et que les tâches peuvent démarrer en retard aux heures de forte charge.
Cron n'a pas de mémoire. Si la machine est éteinte ou si le conteneur ne tourne pas à la minute prévue, cette exécution est tout simplement manquée. Utilisez une file de tâches ou un planificateur avec rattrapage si chaque exécution compte.

Vérifier votre planification

La liste des prochaines exécutions est le contrôle de cohérence le plus rapide. Si les cinq premières heures ne sont pas celles que vous imaginiez, l'expression est fausse. Pour une tâche qui écrit des horodatages dans des journaux ou une base de données, convertissez les valeurs epoch enregistrées avec le convertisseur de timestamp Unix et comparez-les à la planification prévue ; un décalage d'une heure après un changement d'heure est une découverte fréquente.

Pour mesurer l'écart réel entre deux exécutions, le calculateur de durée donne l'intervalle exact en jours, heures et minutes entre deux horodatages.

D'autres outils de planification et de mise en forme se trouvent dans la catégorie développeur.

Essayez

Saisissez ou construisez une expression dans le générateur d'expressions cron, lisez le résumé en langage courant et confirmez les cinq prochaines exécutions avant qu'elle ne parte dans une crontab, un workflow de CI ou un manifeste de CronJob.

Outils de ce guide

Questions fréquentes

Que signifie 0 0 * * * en cron ?

La minute 0 de l'heure 0, tous les jours, tous les mois, tous les jours de la semaine : autrement dit, chaque jour à minuit dans le fuseau horaire du planificateur.

Comment exécuter une tâche cron toutes les 5 minutes ?

Utilisez */5 dans le champ des minutes : */5 * * * *. L'opérateur de pas démarre à 0, la tâche se déclenche donc à :00, :05, :10 et ainsi de suite.

Pourquoi ma tâche cron s'exécute-t-elle des jours supplémentaires quand je renseigne les deux champs de jour ?

En cron standard, le jour du mois et le jour de la semaine sont combinés par un OU, pas par un ET. 0 0 13 * 5 s'exécute le 13 de chaque mois et aussi tous les vendredis.

Quel fuseau horaire cron utilise-t-il ?

Celui de l'hôte ou du service qui exécute le planificateur. Les serveurs, les conteneurs, GitHub Actions et les CronJobs Kubernetes sont en UTC par défaut, sauf configuration contraire.

Plus de guides pour développeurs

Formateur JSON
Développeur · Formatez, validez et minifiez du JSON avec coloration syntaxique.
↵
Encoder / décoder en Base64
Développeur · Encodez un texte en Base64 ou décodez du Base64 en texte brut.
↵
Encodeur / Décodeur d'URL
Développeur · Encodez ou décodez des composants d'URL et des chaînes de requête.
↵
Générateur de hash
Développeur · Générez des hashs MD5, SHA-1, SHA-256 et SHA-512.
↵
Générateur d'UUID
Développeur · Générez des UUID v4 (aléatoires) en masse en un clic.
↵
Testeur de regex
Développeur · Testez des expressions régulières sur du texte avec surbrillance des correspondances en direct.
↵
Compteur de mots
Texte · Comptez les mots, caractères, phrases, paragraphes et le temps de lecture.
↵
Convertisseur de casse
Texte · Convertissez un texte en MAJUSCULES, minuscules, Titre, camelCase, snake_case, etc.
↵
Trieur de listes
Texte · Triez, inversez, dédoublonnez et mélangez des listes de texte.
↵
Aperçu Markdown
Texte · Écrivez du Markdown et voyez l'aperçu rendu en direct, côte à côte.
↵
Calculateur de pourcentage
Nombres · Calculez pourcentages, hausses, baisses et le % d'un nombre par rapport à un autre.
↵
Convertisseur de couleurs
Couleurs · Convertissez instantanément des couleurs entre HEX, RGB, HSL et HSV.
↵
Snake
Arcade · Mangez, grandissez, évitez les murs. Un classique indémodable.
↵
2048
Réflexion · Faites glisser les tuiles et fusionnez-les pour atteindre la légendaire tuile 2048.
↵
Word Grid
Réflexion · Devinez le mot caché de cinq lettres en six essais grâce aux indices de couleur.
↵
Sudoku
Réflexion · Remplissez la grille 9x9 par la logique. Quatre niveaux, de facile à expert.
↵
Démineur
Stratégie · Servez-vous des chiffres pour déminer le terrain. Logique classique, trois niveaux.
↵
Breakout
Arcade · Cassez toutes les briques avec la raquette et la balle. Bonus, combos, niveaux sans fin.
↵
Entraînement dactylo
Détente · Améliorez MPM et précision : exercices de 30 secondes à 5 minutes. Repérez vos touches faibles.
↵
TypeRunner
Arcade · Course de dactylographie multijoueur. Défiez vos amis par lien, battez l'ordinateur ou poursuivez votre fantôme.
↵
Typing Blocks
Arcade · Tapez chaque mot avant que son bloc de bois ne se pose. Ratez, et la pile grimpe vers la ligne.
↵
Bubble Shooter
Arcade · Visez, jouez avec les murs et éclatez des groupes de trois bulles ou plus.
↵
Road Rush
Arcade · Affrontez sept rivaux dans le trafic et prenez la tête à coups de poing.
↵