Skip to main content

Référence de syntaxe des planifications cron

Cette section décrit la syntaxe permettant de définir des exécutions planifiées à l'aide de cron dans Alteryx Analytics Cloud (AAC). En général, cette méthode est utilisée pour les planifications à occurrence répétée.

Note

Les paramètres de fuseau horaire définis sur la page AAC où vous spécifiez votre planification cron sont utilisés avec la planification. Pour utiliser le fuseau horaire UTC, sélectionnez UTC dans la liste déroulante.

Présentation de cron

AAC vous permet d'utiliser cron, une syntaxe largement utilisée pour spécifier les périodes qui se répètent à intervalles réguliers. Vous pouvez utiliser cron pour spécifier des planifications par minute ou par année et des intervalles arbitraires entre les deux.

Syntaxe cron

Un cron planifié est défini sous la forme d'une chaîne de valeurs séparées par des espaces. L'exemple cron suivant définit une planification qui se déclenchera à 23 h 30 le 1er février :

minute

heure

jour du mois

mois

jour de la semaine

30

23

1

2

*

Lorsque toutes les valeurs correspondent, la tâche cron est déclenchée.

Note

La spécification des secondes n'est pas prise en charge.

Caractères génériques :

Dans l'expression cron ci-dessus, le caractère générique * peut être utilisé pour correspondre à n'importe quelle valeur acceptée, ce qui signifie que le type de valeur cron n'est pas un facteur de détermination de cette planification. Comme le caractère générique est appliqué à la valeur du jour de la semaine, la planification peut se déclencher n'importe quel jour de la semaine.

Note

Vous devez utiliser le caractère * dans les champs jour de la semaine ou jour du mois. La spécification des deux champs dans la même expression cron n'est pas prise en charge.

Légende :

À l'exception du dernier champ (année), tous les champs sont obligatoires dans l'expression cron. Les caractères spéciaux sont décrits sous le tableau.

Valeur

Type

Description

Caractères spéciaux pris en charge

30

minute

0-59

, - * /

23

heure

0-23

, - * /

1

jour du mois

1-31

, - * / L W

2

mois

1-12

, - * /

*

jour de la semaine

0 - 6 ou Sun- Sat

0, Sun, SUN = Dimanche

1, Mon, MON = Lundi

...

6, Sat, SAT = Samedi

, - * / L #

*

année

(Facultatif) Vous pouvez spécifier les paramètres de l'année si nécessaire. La valeur par défaut est *.

, - * /

Caractères spéciaux

Vous pouvez utiliser les caractères spéciaux suivants dans vos expressions cron.

Caractère

Description

*

( « toutes les valeurs » ) Caractère générique correspondant à toutes les valeurs possibles dans le champ. Par exemple, si vous voulez que votre déclencheur se déclenche toutes les minutes pendant une heure à partir de 22 h, le caractère minute dans l'expression doit être * . Vous trouverez un exemple ci-dessous.

-

Spécifiez une plage de valeurs. Par exemple, vous pouvez utiliser 1-5 dans le champ du jour de la semaine pour spécifier les jours travaillés de la semaine (du lundi au vendredi). Vous trouverez un exemple ci-dessous.

,

Spécifiez un ensemble distinct de valeurs. Par exemple, l'entrée 1,10,20,30 dans le champ du jour du mois se déclenche les 1er, 10e, 20e et 30e (si possible) jours du mois.

/

Spécifiez les incréments du champ dans les unités du champ. Par exemple, 5/20 dans le champ des minutes correspond à la 5e, 25e et 45e minute de chaque heure.

L

La dernière valeur acceptée dans la plage est acceptée dans les champs suivants :

  • Jour du mois : spécifie le dernier jour du mois pour la valeur de mois actuellement sélectionnée.

    • En janvier, cette valeur correspond à 31 .

    • En février, cette valeur correspond à 28 pour les années non bissextiles.

    • En avril, cette valeur correspond à 30 .

  • Jour de la semaine :

    • En lui-même, il spécifie le dernier jour de la semaine, qui correspond à 6 (samedi).

    • Lorsqu'il est utilisé avec une autre valeur, il spécifie la dernière valeur correspondante pour le mois. Par exemple, 3L correspond au dernier mercredi du mois.

W

Spécifie le jour de la semaine correspondant le plus proche. Par exemple, l'entrée 22W dans le champ du jour du mois correspond au jour de la semaine le plus proche du 22e jour du mois. Si le 22 est un samedi, alors la tâche cron correspond au 24 (le lundi suivant).

Astuce

LW peut être utilisé dans le champ du jour du mois pour spécifier le dernier jour de la semaine du mois.

#

Spécifie le nième jour du mois. Exemples pour le champ du jour de la semaine :

  • 3#4  : quatrième mardi du mois

  • 5#2  : deuxième jeudi du mois

Exemples

Voici quelques exemples de planifications cron.

Toutes les heures

S'exécute à la quinzième minute de chaque heure :

15 * * * *

Quotidienne

S'exécute tous les jours à 22 h :

0 22 * * *

S'exécute toutes les minutes pendant une heure à partir de 22 h, tous les jours :

* 22 * * *

Hebdomadaire

S'exécute tous les mardis à 3 h :

0 3 * * 2

Jours de la semaine

S'exécute tous les jours de la semaine à 20 h :

0 20 * * 1-5

Notez que la planification ci-dessus s'exécute à 20 h le lundi soir et chaque soir de la semaine à cette heure.

Pour chaque matin de la semaine, vous pouvez choisir de démarrer les planifications le dimanche, où la valeur du jour de la semaine commence par 0 et se termine par 4.

Mensuelle

S'exécute le premier jour de chaque mois à 2 h 30 :

30 2 1 * *

S'exécute à 15 h 30 le jour de la semaine (W) le plus proche du 25e jour du mois :

30 15 25W * *
  • Si le 25 est un samedi, la planification se déclenche le vendredi 24.

  • Si le 25 est un dimanche, la planification se déclenche le lundi 26.

Annuel

S'exécute à minuit le 1er janvier de chaque année :

0 0 1 1 * *

Autres exemples

Expression

Signification

0 12 * * *

Exécution à 12 h (midi) tous les jours

15 10 * * *

Exécution à 10 h 15 tous les jours

15 10 * * *

Exécution à 10 h 15 tous les jours

15 10 * * * *

Exécution à 10 h 15 tous les jours

15 10 * * * 2017

Exécution à 10 h 15 tous les jours de l'année 2017

* 14 * * *

Exécution toutes les minutes à partir de 14 h jusqu'à 14 h 59, tous les jours

0/5 14 * * *

Exécution toutes les 5 minutes à partir de 14 h jusqu'à 14 h 55, tous les jours

0/5 14,18 * * *

Exécution toutes les 5 minutes à partir de 14 h jusqu'à 14 h 55 ET exécution toutes les 5 minutes à partir de 18 h jusqu'à 18 h 55, tous les jours

0-5 14 * * *

Exécution toutes les minutes à partir de 14 h jusqu'à 14 h 05, tous les jours

10,44 14 * 3 WED

Exécution à 14 h 10 et à 14 h 44 tous les mercredis du mois de mars.

15 10 * * MON-FRI

Exécution à 10 h 15 tous les lundis, mardis, mercredis, jeudis et vendredis

15 10 15 * *

Exécution à 10 h 15 le 15e jour de chaque mois

15 10 L * *

Exécution à 10 h 15 le dernier jour de chaque mois

15 10 L-2 * *

Exécution à 10 h 15 le deuxième avant-dernier jour de chaque mois

15 10 * * 5L

Exécution à 10 h 15 le dernier vendredi de chaque mois

15 10 * * 5L 2017-2019

Exécution à 10 h 15 tous les derniers vendredis de chaque mois en 2017, 2018 et 2019

15 10 * * 5#3

Exécution à 10 h 15 le troisième vendredi de chaque mois

0 12 1/5 * *

Exécution à 12 h (midi) tous les 5 jours chaque mois, à partir du premier jour du mois.

11 11 11 11 *

Exécution tous les 11 novembre à 11 h 11.

Expressions cron non prises en charge

Note

AAC ne prend pas en charge la combinaison des caractères spéciaux / et - dans les mêmes expressions.

Plutôt que d'exprimer des plages en syntaxe cron, vous pouvez référencer toutes les options possibles.

Expression non valide

Expression valide

0 23 * 1-11/2 * *
0 23 * 2,4,6,8,10 * *

Expressions cron non valides

Expression

Signification

Raison

15 10 * * * 2001

Exécution à 10 h 15 tous les jours de l'année 2001

Cette expression cron n'est pas valide car elle ne générera aucun événement dans le futur.

* * *

-

L'expression cron doit comporter 6 ou 7 champs.