Generatore di espressioni cron

Domande frequenti

Che formato cron usa?

Il formato crontab Unix standard a 5 campi: minuto, ora, giorno del mese, mese, giorno della settimana. Accetta gli operatori * (qualsiasi), */N (ogni N), intervalli come 1-5, elenchi come 1,3,5 e combinazioni come */2,15-20. È lo stesso formato di crontab, dei CronJob di Kubernetes, di GitHub Actions, di GitLab CI e di AWS EventBridge.

Come scrivo un cron ogni 5 minuti?

Con `*/5 * * * *`: */5 nel campo dei minuti vuol dire ogni minuto divisibile per 5 (0, 5, 10 e così via), e gli altri quattro campi su * valgono per ogni ora e ogni giorno. È anche una delle preimpostazioni: clicca Ogni 5 minuti e l'espressione compare nel campo in alto.

Sono supportati i secondi?

No, lo strumento lavora con 5 campi. Il cron a 6 campi (con una colonna iniziale per i secondi) è un'estensione di Quartz e Spring usata dagli scheduler Java. Se stai scrivendo un @Scheduled di Spring o un job Quartz, aggiungi tu lo 0 dei secondi davanti all'espressione.

Come vengono calcolate le prossime esecuzioni?

Lo strumento parte dal minuto successivo a adesso e avanza un minuto alla volta, controllando ogni campo, finché non trova cinque momenti che corrispondono o arriva a circa un anno. Date e ore sono nel fuso orario locale del tuo browser: per vederle in UTC cambia il fuso orario del sistema operativo e ricarica la pagina.

Che differenza c'è tra 0 0 * * 1-5 e */5 9-17 * * 1-5?

La prima parte a mezzanotte dal lunedì al venerdì (cinque volte a settimana). La seconda parte ogni 5 minuti dalle 9:00 alle 17:55, dal lunedì al venerdì (540 volte a settimana). Leggi sempre la descrizione sotto l'espressione prima di mandarla in produzione: la maggior parte degli errori si vede lì.

Perché il mio cron parte più spesso del previsto?

Quasi sempre è la regola dell'OR: quando sono limitati sia il giorno del mese sia il giorno della settimana, il cron standard esegue il job se corrisponde uno dei due. `0 0 15 * 1` vuol dire “a mezzanotte del 15 oppure a mezzanotte di ogni lunedì”, non “solo i lunedì che cadono il 15”. Lascia uno dei due campi su * per avere una sola condizione.

Funziona per Kubernetes CronJob, GitHub Actions e GitLab CI?

Sì, tutti e tre usano il formato standard a 5 campi. Una cosa da controllare: GitHub Actions ragiona in UTC, ovunque tu sia, quindi “0 9 * * *” in un workflow parte alle 9:00 UTC, cioè alle 10:00 o alle 11:00 in Italia a seconda dell'ora legale.

Come faccio un cron che parte l'ultimo giorno del mese?

Con il cron standard a 5 campi non si può in una sola espressione, perché non esiste l'operatore “L” (last), che è un'estensione di Quartz e Spring. La soluzione classica è eseguire il job il 28, 29, 30 e 31 con uno script che controlla `[ "$(date -d tomorrow +%d)" -eq 1 ] && esegui-il-job`. Con Quartz o Spring (`@Scheduled`) puoi scrivere direttamente `0 0 0 L * ?`.

0 */2 * * * è uguale a 0 0,2,4,6,8,10,12,14,16,18,20,22 * * *?

Sì, sono identiche: entrambe partono ogni due ore al minuto 0. `*/2` è la forma breve di “un valore ogni 2 partendo da 0”. Per partire da un'ora dispari (ogni 2 ore a partire dall'1:00) ti serve l'elenco esplicito `0 1,3,5,7,9,11,13,15,17,19,21,23 * * *`, perché */2 parte sempre da 0.

Posso usare i nomi di mesi e giorni invece dei numeri?

In molti scheduler sì: JAN-DEC per i mesi e SUN-SAT per i giorni, senza distinzione tra maiuscole e minuscole, quindi `0 9 * * MON-FRI` equivale a `0 9 * * 1-5`. Questo editor però accetta solo cifre e gli operatori * - / , quindi qui scrivi `0 9 * * 1-5`. La forma numerica è comunque la più sicura tra piattaforme diverse.

L'espressione cron viene inviata da qualche parte?

No. Validazione, descrizione e calcolo delle prossime esecuzioni girano in JavaScript nella scheda del browser. Nella scheda Rete degli strumenti per sviluppatori non parte nessuna richiesta, e non viene salvato niente.