Calcularea următoarelor execuții ale unei expresii cron

O expresie cron este un șir scurt care descrie o recurență în timp. Formatul moștenit de la Unix se compune din cinci câmpuri separate prin spații: minut, oră, zi din lună, lună și zi din săptămână. Această sintaxă s-a născut cu demonul cron al lui Brian Kernighan în anii 1970, apoi generalizată de Vixie cron (1987) preluat de toate distribuțiile Linux și macOS moderne. Astăzi, aceeași sintaxă se regăsește în majoritatea planificatorilor cloud (AWS EventBridge, GCP Cloud Scheduler, Azure Logic Apps) și CI/CD (GitHub Actions, GitLab CI, Jenkins).

┌──── minut (0-59)
│ ┌── oră (0-23)
│ │ ┌── zi din lună (1-31)
│ │ │ ┌── lună (1-12 sau JAN-DEC)
│ │ │ │ ┌── zi din săptămână (0-7 sau SUN-SAT, 0 și 7 = duminică)
│ │ │ │ │
* * * * *

O expresie cron bine formată definește deci un cron schedule precis: fiecare câmp poate fi o valoare fixă, un interval, o listă, un pas sau un asterisc care se potrivește la tot. Compactitatea expresiei crontab este forța sa, dar este de asemenea ceea ce face un cron decoder indispensabil pentru a valida vizual intenția. Acesta este întregul obiect al acestui cron converter: a produce o explicație cron lizibilă, plus lista următoarelor execuții.

Cele cinci câmpuri împărtășesc o gramatică comună. Iată limitele acceptate de fiecare coloană a unei expresii crontab standard:

• Minut: 0-59.
• Oră: 0-23, format 24h.
• Zi din lună: 1-31.
• Lună: 1-12 sau abrevierile textuale JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
• Zi din săptămână: 0-7 unde 0 și 7 reprezintă amândouă duminica, sau abrevierile SUN, MON, TUE, WED, THU, FRI, SAT.

Caractere speciale împărtășite de cele cinci câmpuri:

• *: any value, se potrivește cu toate valorile autorizate ale câmpului.
• ,: listă discretă, de exemplu 1,15,30 în câmpul minut.
• -: interval inclusiv, de exemplu 9-17 pentru orele de birou.
• /: pas (step), de exemplu */15 = la fiecare 15 unități, sau 0-30/5 = la fiecare 5 minute între 0 și 30.

Extensii Quartz (Java, AWS EventBridge, Spring): gramatica urcă la 6 sau 7 câmpuri cu o coloană secunde în cap (0-59) și uneori o coloană an în coadă (1970-2099). Quartz introduce de asemenea ? (no specific value, pentru a decupla zi-din-lună și zi-din-săptămână), L (last: ultima zi a lunii, sau ultima vineri cu 5L), W (zi lucrătoare cea mai apropiată) și # (a N-a zi a săptămânii a lunii, de exemplu 2#3 pentru al 3-lea luni). O expresie Quartz nu este în general compatibilă cu un crontab UNIX, și viceversa: este principala sursă de eroare când copiezi o cron expression de la o platformă la alta. Decoder-ul nostru vizează formatul cu 5 câmpuri, care acoperă majoritatea planificatorilor.

# UNIX / Vixie cron (5 câmpuri)
0 9 * * 1-5

# Quartz (6 câmpuri cu secunde)
0 0 9 ? * MON-FRI

# Quartz (7 câmpuri cu an)
0 0 9 ? * MON-FRI 2026

A citi 0 0 * * * este rapid. A citi */7 2-5 1,15 * 1-5 este net mai puțin. Când o expresie iese din trivial, riscul de eroare de interpretare urcă și cron decode devine o etapă de review în sine.

• Debug producție: a înțelege de ce o sarcină s-a declanșat la 03h17 și nu la 03h00, sau a identifica o suprapunere între două joburi.
• Code review: a valida că un planificator împins într-un pull request face într-adevăr ce pretinde autorul, fără a fi nevoie să memorezi semantica fiecărui simbol.
• Audit de planificatori: a trece în revistă cron job-urile Linux din /etc/crontab și /etc/cron.d/, trigger-urile Jenkins, spec.schedule-urile Kubernetes CronJob, regulile AWS EventBridge și job-urile GCP Cloud Scheduler.
• Migrare legacy: a relua un /etc/crontab istoric fără documentație și a reconstrui cartografia sarcinilor înainte de o schimbare de infrastructură.
• Onboarding: a permite unui nou dezvoltator să relucreze o crontab fără a fi nevoie să învețe toate caracterele speciale dintr-o zi pe alta.

Pașii de urmat pentru a decoda o expresie crontab cu instrumentul:

1. Lipește cron expression-ul tău în câmpul de intrare (5 câmpuri separate prin spații).
2. Indică numărul de execuții următoare de calculat.
3. Apasă pe convert pentru a lansa cron decode-ul: instrumentul returnează o frază umană care explică declanșarea, plus lista datată a execuțiilor următoare.
4. Verifică vizual că datele corespund intenției tale (oră, zi, frecvență).
5. Copiază ieșirea prin butonul de copiere pentru a o lipi într-un tichet, un PR sau o documentație tehnică.

Instrumentul nu se mulțumește cu un parsing sintactic: furnizează o explicație cron în limbaj natural, ceea ce face din el atât un cron decoder cât și un validator de planificare.

Pattern-urile de mai jos acoperă esențialul cron schedule-urilor întâlnite în producție. Sunt toate valide pe Linux crontab, Kubernetes CronJob, GitHub Actions și majoritatea planificatorilor aplicativi.

Pentru a executa o sarcină cron pe un server Linux, se editează crontab-ul utilizator din shell:

# editare crontab al utilizatorului curent
$ crontab -e

# listare sarcinilor existente
$ crontab -l

# exemplu de linie adăugată: backup zilnic la 3h
0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1

Exemplu de ieșire a cron converter-ului pentru */5 * * * *:

2026-05-05 00:00:00
2026-05-05 00:05:00
2026-05-05 00:10:00
2026-05-05 00:15:00
2026-05-05 00:20:00
...