WebGroundwebground.app
Infos & Guides · Référence Dev

Guide des Expressions Cron et Analyseur de Planification

Comprenez la syntaxe de planification cron grâce à des exemples courants, et collez n'importe quelle expression à cinq champs pour la vérifier et afficher ses prochaines exécutions.

Vérifier une expression cron

Cinq champs séparés par des espaces : minute, heure, jour du mois, mois, jour de la semaine.

Expression cron valide

Décomposition champ par champ

  • Minute

    Autorisé : 0 à 59

    Valeur
    */15
    Correspond à
    • 0
    • 15
    • 30
    • 45
  • Heure

    Autorisé : 0 à 23

    Valeur
    9-17
    Correspond à
    • 9 à 17
  • Jour du mois

    Autorisé : 1 à 31

    Valeur
    *
    Correspond à
    Chaque jour du mois
  • Mois

    Autorisé : 1 à 12

    Valeur
    *
    Correspond à
    Chaque mois
  • Jour de la semaine

    Autorisé : 0 à 7

    Valeur
    MON-FRI
    Correspond à
    • lundi à vendredi

Prochaines exécutions

Planifications courantes

  • * * * * *
    Moment d'exécution
    Chaque minute
    Raccourci
  • */5 * * * *
    Moment d'exécution
    Toutes les 5 minutes
    Raccourci
  • */30 * * * *
    Moment d'exécution
    Toutes les 30 minutes
    Raccourci
  • 0 * * * *
    Moment d'exécution
    Toutes les heures, à l'heure pile
    Raccourci
    @hourly
  • 0 */6 * * *
    Moment d'exécution
    Toutes les 6 heures, à partir de minuit
    Raccourci
  • 0 0 * * *
    Moment d'exécution
    Tous les jours à minuit
    Raccourci
    @daily
  • 30 8 * * *
    Moment d'exécution
    Tous les jours à 8 h 30
    Raccourci
  • 0 9 * * 1-5
    Moment d'exécution
    Du lundi au vendredi à 9 h 00
    Raccourci
  • 0 0 * * 0
    Moment d'exécution
    Tous les dimanches à minuit
    Raccourci
    @weekly
  • 0 0 1 * *
    Moment d'exécution
    À minuit le premier jour de chaque mois
    Raccourci
    @monthly
  • 0 0 1 */3 *
    Moment d'exécution
    À minuit le premier jour de janvier, d'avril, de juillet et d'octobre
    Raccourci
  • 0 0 1 1 *
    Moment d'exécution
    À minuit le 1er janvier de chaque année
    Raccourci
    @yearly

Caractères spéciaux

  • *
    Signification
    Toutes les valeurs du champ.
    Exemple
    * * * * *
  • ,
    Signification
    Une liste de valeurs distinctes.
    Exemple
    0 9,18 * * *
  • -
    Signification
    Une plage de valeurs, bornes incluses.
    Exemple
    0 9-17 * * *
  • /
    Signification
    Un pas : une valeur sur n, en comptant depuis le début de la plage.
    Exemple
    */10 * * * *

Comment se construit une expression cron

Une expression cron se compose de cinq champs séparés par des espaces : minute, heure, jour du mois, mois et jour de la semaine. Chaque champ indique quand la tâche peut s'exécuter, et la tâche s'exécute à chaque minute où tous les champs concordent.

Un champ peut contenir un nombre seul, un astérisque pour toutes les valeurs, une liste séparée par des virgules, une plage avec un tiret ou un pas avec une barre oblique. Les mois et les jours de la semaine peuvent aussi s'écrire avec leur nom anglais en trois lettres, comme JAN ou MON.

Les pièges les plus fréquents

Une planification qui semble correcte peut tout de même s'exécuter à des moments inattendus.

  • Cron utilise le fuseau horaire du serveur, qui peut différer du vôtre. Les heures d'exécution ci-dessus utilisent le fuseau horaire de votre appareil.
  • Lorsque le jour du mois et le jour de la semaine sont tous deux définis, la tâche s'exécute dès que l'un des deux correspond.
  • Dans le champ du jour de la semaine, 0 et 7 désignent tous deux le dimanche.
  • Un pas tel que */7 repart de zéro à chaque nouvelle heure, nouveau jour ou nouveau mois : les intervalles ne sont donc pas toujours réguliers.

Questions fréquentes

Pourquoi mon expression à six champs est-elle refusée ?+

Le cron standard sous Linux et macOS utilise cinq champs. Les expressions à six ou sept champs proviennent de Quartz, de Spring et de planificateurs similaires, qui ajoutent un champ pour les secondes et parfois un autre pour l'année, et emploient des symboles supplémentaires tels que ? et L.

Que signifient les raccourcis tels que @daily ?+

Ce sont des noms courts pour des planifications courantes. @hourly, @daily, @weekly, @monthly et @yearly s'exécutent au début de chaque heure, jour, semaine, mois ou année. @reboot s'exécute une seule fois au démarrage : il n'a donc aucune heure d'exécution à afficher.

L'expression que je saisis est-elle envoyée quelque part ?+

Non. L'expression est vérifiée et les heures d'exécution sont calculées dans votre navigateur.

Explorer plus sur WebGround

Tout voir