Comment vérifier une expression cron et ses prochaines occurrences

Présentation du contrôle

Cet outil vérifie une expression cron à cinq champs et calcule ses cinq prochaines occurrences lorsque le calcul aboutit. Il permet de relire un planning avant d’utiliser les dates obtenues, par exemple pour contrôler une tâche récurrente ou repérer une position mal interprétée.

Les champs sont lus dans cet ordre : minute, heure, jour du mois, mois, jour de la semaine. Cette organisation doit rester en tête lors de la saisie, car chaque valeur dépend de sa position. Si aucune expression n’est fournie, le contrôle utilise */5 * * * * par défaut.

Les espaces sont préparés avant la validation : ceux placés au début ou à la fin sont retirés, et plusieurs espaces consécutifs sont réduits à un seul. Cette préparation ne remplace toutefois pas la structure attendue, qui repose sur cinq champs séparés par des espaces.

Méthode de contrôle

1. Saisissez l’expression cron dans le champ prévu. Pour utiliser la valeur intégrée, laissez ce champ vide ; le contrôle appliquera alors */5 * * * *. Une présentation avec des espaces superflus peut être conservée, puisqu’ils sont normalisés avant la validation.

2. Comptez les champs après cette normalisation. Il doit y en avoir exactement cinq, dans l’ordre minute, heure, jour du mois, mois et jour de la semaine. Un nombre différent entraîne un échec avant la recherche des occurrences.

3. Lancez le contrôle, puis tenez compte de son point de départ. Le calcul commence à l’heure UTC actuelle, après suppression des fractions de seconde. Les prochaines correspondances sont ensuite recherchées dans le calendrier.

4. Consultez la réponse obtenue. En cas de réussite, cinq occurrences calendaires sont renvoyées comme chaînes de date et d’heure au format ISO, avec UTC indiqué comme fuseau.

5. Si l’expression restreint à la fois le jour du mois et le jour de la semaine, appliquez une logique OU pour lire les correspondances. Enfin, gardez en mémoire que la recherche est limitée à dix ans entre deux occurrences : une syntaxe valide peut donc encore conduire à un échec.

Lecture de la réponse

Une réussite signifie que cinq occurrences ont été trouvées dans la période de recherche prévue. Les valeurs renvoyées représentent des instants en UTC ; ne les lisez pas comme des horaires locaux sans effectuer ensuite la conversion appropriée pour votre contexte.

Pour vérifier la cohérence du calendrier, rapprochez chaque résultat des cinq positions saisies. Avec 0 0 1 * *, la correspondance attendue concerne le premier jour d’un mois à minuit, ce qui fournit une série de cinq dates mensuelles au format ISO et marquées UTC.

Un échec peut avoir plusieurs origines : syntaxe, date, valeur ou analyse d’une clé. Il peut également survenir si aucune prochaine correspondance n’est trouvée dans la période maximale de dix ans. La forme à cinq champs ne permet pas de conclure que d’autres variantes cron sont acceptées.

Exemple pratique

Vous devez contrôler qu’une tâche mensuelle est prévue à minuit le premier jour de chaque mois.

Saisissez 0 0 1 * *, lancez le contrôle, puis examinez les cinq dates renvoyées pour vérifier qu’elles correspondent à des premiers jours de mois à minuit.

La réponse prend la forme de cinq chaînes de date et d’heure au format ISO, avec UTC indiqué comme fuseau ; chacune correspond au premier jour d’un mois à minuit.

Limites

• La recherche s’arrête à une période maximale de dix ans entre deux occurrences ; l’absence de résultat dans cette limite provoque un échec malgré une syntaxe valide.

Erreurs fréquentes

• Cause : un champ manque, un élément est en trop ou une valeur occupe la mauvaise position. Correction : recomptez les cinq éléments et relisez-les dans la séquence minute, heure, jour du mois, mois, jour de la semaine.

Questions fréquentes

Que se passe-t-il si je laisse l’expression vide ?

Lorsque le champ est vide, */5 * * * * est utilisé par défaut. Les espaces autour d’une saisie ou entre ses éléments sont ensuite normalisés avant la vérification.

Dans quel fuseau horaire les prochaines occurrences sont-elles calculées ?

Le calcul part de l’heure UTC actuelle, sans fractions de seconde. Les cinq résultats sont renvoyés sous forme de chaînes ISO et comportent l’indication UTC comme fuseau.

Comment sont combinés le jour du mois et le jour de la semaine ?

Quand les deux restrictions sont présentes, une correspondance OU est appliquée. Une date peut donc être retenue parce qu’elle respecte le jour du mois ou le jour de la semaine.