Come analizzare un’espressione cron e trovare le prossime esecuzioni

A cosa serve

Questo strumento controlla un’espressione cron a cinque campi e, quando il calcolo riesce, individua le cinque esecuzioni successive rispetto all’ora UTC corrente. È utile per verificare rapidamente una pianificazione ricorrente prima di interpretarne le prossime occorrenze. L’ordine dei campi è minuto, ora, giorno del mese, mese, giorno della settimana.

Come usarlo

1. Inserisci un’espressione cron con cinque campi separati da spazi. Se lasci vuoto il campo, viene usata l’espressione predefinita */5 * * * *.
2. Controlla che i valori seguano l’ordine minuto, ora, giorno del mese, mese e giorno della settimana. Il numero dei campi deve essere esattamente cinque: un numero diverso porta al fallimento prima del calcolo dell’orario.
3. Separa i campi con spazi normali. Gli spazi ripetuti vengono normalizzati e quelli all’inizio o alla fine vengono rimossi prima della verifica.
4. Avvia il controllo e il calcolo. La ricerca parte dall’ora UTC corrente, senza considerare le frazioni di secondo.
5. Leggi le cinque occorrenze successive nel risultato. Sono date e orari in formato ISO, con l’indicazione del fuso orario UTC.

Per esempio, 0 0 1 * * significa minuto 0, ora 0, primo giorno del mese, ogni mese e ogni giorno della settimana. Quando la ricerca trova gli appuntamenti previsti, il risultato contiene cinque occorrenze di calendario: ciascuna cade il primo giorno di un mese a mezzanotte UTC.

Come interpretare il risultato

Un risultato con cinque date indica che la sintassi e i valori sono stati accettati e che sono state trovate cinque occorrenze future entro il limite di ricerca. Se sia il giorno del mese sia il giorno della settimana contengono restrizioni, la corrispondenza segue una logica OR: è sufficiente che sia rispettata una delle due condizioni.

Il fallimento non significa soltanto che la sintassi è errata. Può verificarsi anche con un’espressione sintatticamente valida se non esiste una prossima corrispondenza entro dieci anni. Anche gli errori gestiti nella lettura della sintassi, delle date, dei valori o delle chiavi producono un fallimento invece dei dati della pianificazione.

Interpreta quindi le date come le prossime cinque occorrenze calcolate da questo riferimento UTC, non come una conversione automatica nell’ora locale. Il formato a cinque campi non dimostra il supporto per espressioni a sei campi o per ogni variante di cron.

Esempio pratico

Devi controllare una pianificazione che deve scattare a mezzanotte del primo giorno di ogni mese.

Inserisci 0 0 1 * * e avvia il controllo. Verifica che le cinque occorrenze riportate siano appuntamenti di calendario sul primo giorno del mese alle 00:00 UTC.

Il risultato contiene cinque date e orari in formato ISO con UTC indicato; per questa espressione, le date cadono il primo giorno di mesi successivi a mezzanotte UTC.

Limiti

• La verifica usa cinque campi e una ricerca limitata a dieci anni; non è una conferma del supporto per espressioni a sei campi o per ogni dialetto cron.

Errori comuni

• Usare un numero di campi diverso da cinque. Conta i valori e verifica l’ordine minuto, ora, giorno del mese, mese e giorno della settimana prima di avviare il controllo.

Domande frequenti

Quale espressione viene usata se lascio il campo vuoto?

Sì, se non inserisci un’espressione viene usato */5 * * * *. Con un’espressione presente, invece, deve contenere esattamente cinque campi separati da spazi.

In quale formato vengono mostrate le prossime esecuzioni?

Le cinque occorrenze sono restituite come stringhe di data e ora in formato ISO, con UTC indicato come fuso orario.

Perché un’espressione cron valida può restituire un fallimento?

Può fallire anche quando la sintassi è valida: accade se non viene trovata una prossima corrispondenza entro il limite di ricerca di dieci anni. Il fallimento può inoltre derivare da errori gestiti nella sintassi, nelle date, nei valori o nelle chiavi.