Format de job Cron et fuseau horaire

Les jobs Cron sont planifiés à intervalles récurrents, spécifiés à l'aide d'un format basé sur unix-cron. Vous pouvez définir un calendrier afin que votre tâche s'exécute plusieurs fois par jour, uniquement certains jours ou uniquement certains mois. (Bien que nous ne recommandions plus son utilisation, la planification d'un job en créant un fichier cron.yaml est toujours compatible avec les jobs existants.)

Cloud Scheduler permet également de planifier des jobs dans un format plus lisible par l'humain. Pour en savoir plus, consultez la section Autre format de job de ce document.

Format de job Cron

Vous pouvez utiliser la console Google Cloud , la Google Cloud CLI ou l'API REST Cloud Scheduler pour définir votre programmation.

Une programmation est définie à l'aide du format de chaîne unix-cron (* * * * *), qui est un ensemble de cinq champs sur une ligne, indiquant quand le job doit être exécuté.

Les champs d'heure ont le format et les valeurs possibles suivants, et doivent respecter cet ordre :

|------------------------------- Minute (0-59)
|     |------------------------- Hour (0-23)
|     |     |------------------- Day of the month (1-31)
|     |     |     |------------- Month (1-12; or JAN to DEC)
|     |     |     |     |------- Day of the week (0-6; or SUN to SAT; or 7 for Sunday)
|     |     |     |     |
|     |     |     |     |
*     *     *     *     *
Champ Format des valeurs valides
Minute 0-59
Heure 0-23
jour du mois 1-31
Mois 1-12 (ou JAN à DEC)
Jour de la semaine 0-6 (ou SUN à SAT, ou 7 pour dimanche)
  • Minute : indique le nombre de minutes écoulées depuis le début de l'heure à laquelle votre tâche s'exécute. Par exemple, si la minute est définie sur 0, le job s'exécute au début de l'heure (car cela correspond à 0 minute après l'heure). Par exemple, si l'heure est 8h00, le job s'exécute à 8h00.

  • Heure : indique le nombre d'heures écoulées depuis minuit avant l'exécution de votre job (arrondi à l'heure inférieure, car les minutes restantes sont indiquées dans le champ minute). Minuit correspond à 0 et midi à 12. Par exemple, si l'heure est définie sur 0, le job s'exécute à minuit (car il s'agit de 0 heure après minuit).

  • Jour du mois : indique la date calendaire du mois. Par exemple, 1 pour le premier jour du mois. Cloud Scheduler n'accepte pas L pour désigner le dernier jour du mois.

  • Mois : indique le mois. Spécifiez le numéro du mois ou les trois premières lettres du nom du mois en majuscules. Par exemple, 1 pour janvier, ou l'équivalent, JAN.

  • Jour de la semaine : indique le jour de la semaine. Par exemple, lundi correspond à 1 et mardi à 2. 0 ou 7 peut indiquer le dimanche. Spécifiez le jour de la semaine par un chiffre ou par les trois premières lettres du nom du jour de la semaine en majuscules (par exemple, SUN pour dimanche).

    • Ce champ est évalué en tant que OR inclusif avec le champ day of the month, sauf si l'un de ces champs est marqué comme sans restriction par l'astérisque (*). Par exemple, si le jour du mois est défini sur 1 et que le jour de la semaine est défini sur SAT, le job s'exécute le premier jour du mois et tous les samedis du mois, même si le premier jour du mois n'est pas un samedi. Si le jour de la semaine n'est pas limité (défini sur *), le job ne s'exécute que le premier jour du mois.

Correspondant à toutes les valeurs

Pour faire correspondre toutes les valeurs d'un champ, utilisez l'astérisque : *. Lorsqu'un champ est défini sur l'astérisque, il correspond à toutes les valeurs valides pour ce champ chaque fois que les autres conditions de champ sont remplies. Définir un champ sur l'astérisque est parfois appelé laisser le champ sans restriction, car il n'est pas limité à une valeur spécifique.

Voici deux exemples dans lesquels le champ des minutes n'est pas limité :

  • * 0 1 1 1 : le job s'exécute toutes les minutes de minuit à 1h du matin le 1er janvier et les lundis.
  • * * * * * : le job s'exécute toutes les minutes (de chaque heure, de chaque jour du mois, de chaque mois, de chaque jour de la semaine, car chacun de ces champs est également sans restriction).

L'astérisque équivaut à un cas particulier de plage, où la plage commence à la première valeur valide du champ et se termine à la dernière valeur valide du champ (par exemple, 0-59 pour le champ des minutes).

Correspondance avec une plage

Pour faire correspondre une plage de valeurs, spécifiez vos valeurs de début et de fin, séparées par un trait d'union (-). N'incluez pas d'espaces dans la plage. Les plages sont inclusives. Le premier nombre doit être inférieur au second. Si vous utilisez des noms abrégés pour le mois ou le jour de la semaine (par exemple, JAN au lieu de 1 pour le premier mois de l'année), la première valeur doit être antérieure à la seconde dans le mois ou la semaine.

Les exemples équivalents suivants s'exécutent à minuit les lundis, mardis, mercredis, jeudis et vendredis (pour tous les mois) :

  • 0 0 * * 1-5
  • 0 0 * * MON-FRI

Correspondance avec une liste

Les listes peuvent contenir n'importe quelle valeur valide pour le champ, y compris des plages. Spécifiez vos valeurs en les séparant par une virgule (,). N'incluez pas d'espaces dans la liste.

Exemples :

  • 0 0,12 * * * : le job s'exécute à minuit et à midi.
  • 0-5,30-35 * * * * : le job s'exécute pendant les cinq premières minutes de chaque demi-heure (au début de l'heure et à la demi-heure).

Ignorer des valeurs dans une plage

Vous pouvez ignorer des valeurs dans une plage en spécifiant un taux de progression dans la plage. On parle parfois d'utilisation d'une fonction d'étape (ou d'une valeur d'étape ou d'une expression de taux). Pour ce faire, spécifiez la plage, suivie d'une barre oblique (/) et de la fréquence à laquelle vous souhaitez ignorer les valeurs de la plage.

Vous pouvez utiliser l'astérisque (*) pour indiquer la plage de toutes les valeurs du champ. Lorsque vous utilisez l'astérisque, la première valeur de la plage est : 0 pour les champs de minute, d'heure et de jour de la semaine (dimanche), et 1 pour les champs de jour du mois et de mois.

La valeur de l'étape ne peut pas être supérieure à la valeur maximale possible pour le champ. Le pas par défaut est de 1. Par conséquent, la fonction de pas /1 équivaut à ne pas utiliser de fonction de pas du tout.

Exemples de plages utilisant des fonctions d'échelon :

  • */2 : il s'agit d'une fonction d'étape valide pour n'importe quel champ. Pour le champ des minutes, il correspond à 0, 2, 4, ... , 58. Pour l'heure, il correspond à 0, 2, 4, ... , 22. Pour le jour du mois, il correspond à 1, 3, 5, ... , 31 (pour un mois de 31 jours). Pour le mois, il correspond à 1, 3, 5, ... , 11. Pour le jour de la semaine, il correspond à 0, 2, 4, 6.

  • 0-12/2 : il s'agit d'une fonction de pas valide pour les champs des minutes et des heures. Il correspond à 0, 2, 4, ... , 12.

Exemples de planifications utilisant des fonctions en escalier :

  • */2 * * * * : le job s'exécute toutes les deux minutes.

  • 0 0-12/2 * * * : le job s'exécute toutes les deux heures, à l'heure pile. La première exécution a lieu à minuit. La dernière course est à midi.

Exemples de calendrier

Le tableau suivant présente quelques exemples de planifications de job Cron et leur description :

Programmer Format de job Cron Explication
Toutes les minutes * * * * * S'exécute à la minute. Par exemple, 9h00, 9h01, 9h02, etc.
Toutes les heures 0 * * * * S'exécute toutes les heures. Par exemple, 9h00, 10h00, 11h00, etc.
Tous les jours 0 0 * * * Exécution tous les jours à minuit (00:00 au format 24 heures).
Tous les jours de la semaine
(lun-ven)
Les éléments suivants sont équivalents :
  • 0 0 * * 1-5
  • 0 0 * * MON-FRI
Exécution à minuit (00:00 au format 24 heures) les lundis, mardis, mercredis, jeudis et vendredis.
Toutes les semaines Les éléments suivants sont équivalents :
  • 0 0 * * 0
  • 0 0 * * 7
  • 0 0 * * SUN
Exécution le dimanche à minuit (00:00 au format 24 heures).
Tous les mois 0 0 1 * * S'exécute à minuit (00:00 au format 24 heures) le premier jour du mois.
Tous les trimestres Les éléments suivants sont équivalents :
  • 0 0 1 1,4,7,10 *
  • 0 0 1 JAN,APR,JUL,OCT *
S'exécute à minuit (00:00 au format 24 heures) le premier jour du trimestre, pour une planification trimestrielle standard : 1er janvier, 1er avril, 1er juillet et 1er octobre.
Tous les ans Les éléments suivants sont équivalents :
  • 0 0 1 1 *
  • 0 0 1 JAN *
S'exécute à minuit (00:00 au format 24 heures) le premier jour du premier mois de l'année (1er janvier).

Fuseau horaire

Vous pouvez sélectionner le fuseau horaire pour évaluer la planification dans la consoleGoogle Cloud (sur la page Créer un job, sélectionnez un fuseau horaire dans la liste) ou via l'option gcloud --time-zone lorsque vous créez le job.

La valeur de ce champ doit être l'abréviation du fuseau horaire utilisée dans la base de données tz. Le fuseau horaire par défaut est UTC.

Pour certains fuseaux horaires, l'heure d'été peut entraîner l'exécution ou la non-exécution inattendue de jobs. En effet, Cloud Scheduler s'exécute en fonction de l'heure réelle. Dans les cas où une heure peut se produire deux fois (par exemple, lorsque l'heure est reculée) et que votre job est planifié à cette heure, votre job planifié peut présenter des anomalies d'exécution.

Si votre job nécessite une cadence très spécifique, vous pouvez envisager de choisir un fuseau horaire qui n'observe pas l'heure d'été. Plus précisément, il est recommandé d'utiliser le fuseau horaire UTC pour Cloud Scheduler afin d'éviter complètement le problème.

Autre format de job

Vous pouvez utiliser un format de spécification de l'heure plus lisible par l'humain, appelé groc, qui offre une alternative aux expressions cron. Par exemple, certains événements périodiques peuvent être difficiles à spécifier à l'aide de cron, comme le "troisième mardi de chaque mois" ou "toutes les deux semaines" (toutes les 336 heures). Dans ce cas, vous pouvez utiliser des constructions comme celles-ci :

03 of month 12:34
1,3,4,7,11,18,29 of jan,jul 12:34
1st friday of quarter 9:00
1st,third monday of month 04:00
2nd,3rd tue,wed,thu of feb,aug 13:50
every 336 hours
every 48 hours
every 5 minutes
every 60 minutes on mon,wed
every day 09:00
every minute
every sun,tue,thu 9:00
every wed of december 00:00
first sunday of month 12:00
second,4th tue,thursday of 3rd month of quarter 18:30

Lorsque vous spécifiez une planification de job à l'aide de groc, vous devez utiliser la gcloud CLI ou envoyer une requête directe à l'API Cloud Scheduler.

Pour en savoir plus sur la syntaxe, consultez Définir la planification du job Cron.

Étapes suivantes