Generatore di espressioni cron

Come costruire un’espressione cron

1. Scrivi o incolla un’espressione in Espressione cron, oppure scegline una dalle Preimpostazioni. Sono accettate anche macro come @daily o @weekly.
2. In alternativa usa il Costruttore: per ogni campo scegli una Modalità (Ogni, Ogni N, Valori specifici, Intervallo o Personalizzato) e compila il Valore. L’espressione si aggiorna man mano, e se modifichi l’espressione si aggiorna il costruttore.
3. Spunta Aggiungi un campo dei secondi (6 campi) se il tuo scheduler supporta i secondi.
4. Leggi la pianificazione In parole semplici (in italiano), poi controlla l’elenco delle Prossime esecuzioni, con date e orari scritti all’italiana. Scegli il Fuso orario del server che esegue il job e Quante esecuzioni elencare.
5. Copia l’espressione con Copia, oppure usa uno degli Altri formati.

Gli errori vengono spiegati campo per campo, per esempio “Minuto: 61 è fuori intervallo (0–59)”, così sai esattamente cosa correggere.

I cinque campi di cron

Una riga di cron standard (Vixie) ha cinque campi, seguiti dal comando:

Ogni campo accetta * (tutti i valori), un elenco 1,15, un intervallo 9-17, un passo */15 (ogni 15 unità) o un intervallo con passo 0-30/10. Quindi */15 9-17 * * 1-5 significa ogni 15 minuti dalle 9:00 alle 17:45, dal lunedì al venerdì. I nomi di mesi e giorni restano in inglese (JAN, MON…), perché è così che li legge cron.

Una regola sorprende molti: quando sono limitati sia il Giorno del mese sia il Giorno della settimana, il cron classico esegue quando corrisponde uno dei due. 0 0 13 * 5 gira ogni giorno 13 e ogni venerdì, non solo il venerdì 13. In quel caso lo strumento mostra un avviso.

Prossime esecuzioni e fusi orari

Cron usa l’orologio della macchina, oppure l’impostazione CRON_TZ/TZ della crontab. L’elenco delle Prossime esecuzioni è calcolato per il fuso orario che scegli, compresi i cambi dell’ora legale: durante il passaggio di primavera un job impostato alle 2:30 può essere saltato, e in autunno può girare una o due volte a seconda dell’implementazione. Per i job che devono girare esattamente una volta, preferisci orari fuori dalla fascia 1:00–3:00 oppure usa UTC.

Vixie cron, timer systemd, Quartz e AWS

• I timer systemd usano OnCalendar= con una sintassi diversa: Mon..Fri *-*-* 09..17:00/15:00. Le condizioni su giorno della settimana e data vengono combinate con AND, non con OR, quindi alcune espressioni cron non hanno un equivalente esatto.
• Quartz e Spring mettono un campo dei secondi all’inizio e possono aggiungere un campo anno. Uno dei due campi del giorno deve essere ?, e Quartz numera i giorni della settimana da 1 a 7 partendo dalla domenica, a differenza dello 0–6 di cron. Lo strumento scrive i giorni come nomi (MON-FRI) per evitare questa trappola.
• AWS EventBridge usa cron(minuti ore giorno mese giorno-della-settimana anno): sei campi, niente secondi, un ? in uno dei campi del giorno e l’anno alla fine.

Il cron standard non ha un campo dei secondi. La forma a 6 campi con i secondi è supportata da molte librerie (node-cron, Spring, Quartz) ma non dalla crontab di sistema.