Cron-udtryk: generator og forklaring

Sådan bygger du et cron-udtryk

1. Skriv eller indsæt et udtryk i Cron-udtryk, eller vælg et i Forvalg. Makroer som @daily eller @weekly accepteres også.
2. Eller brug Byggeværktøj: For hvert felt vælger du en Tilstand (Hver, Hver N, Bestemte værdier, Interval eller Brugerdefineret) og udfylder Værdi. Udtrykket opdateres undervejs, og når du redigerer udtrykket, opdateres byggeværktøjet.
3. Sæt kryds ved Tilføj et sekundfelt (6 felter), hvis din planlægger understøtter sekunder.
4. Læs tidsplanen På almindeligt dansk, og tjek derefter listen Næste kørsler. Vælg Tidszone for den server, der kører jobbet, og Hvor mange kørsler, der skal vises.
5. Kopiér udtrykket med Kopiér, eller brug et af Andre formater.

Fejl forklares felt for felt, for eksempel »Minut: 61 ligger uden for intervallet (0–59)«, så du ved præcis, hvad der skal rettes.

Beskrivelsen af tidsplanen på dansk kommer fra biblioteket cronstrue, som indlæses ved behov. Datoerne for de næste kørsler vises efter danske regler.

De fem cron-felter

En standard cron-linje (Vixie) har fem felter og derefter kommandoen:

Hvert felt accepterer * (alle værdier), en liste 1,15, et interval 9-17, et trin */15 (hver 15. enhed) eller et interval med trin 0-30/10. Så */15 9-17 * * 1-5 betyder hvert 15. minut fra kl. 9.00 til 17.45, mandag til fredag.

En regel overrasker mange: Når både Dag i måneden og Ugedag er begrænset, kører klassisk cron, når en af dem passer. 0 0 13 * 5 kører den 13. i hver måned og hver fredag, ikke kun fredag den 13. Værktøjet viser en advarsel i det tilfælde.

Næste kørselstidspunkter og tidszoner

Cron bruger maskinens ur eller indstillingen CRON_TZ/TZ i crontab. Listen Næste kørsler beregnes for den tidszone, du vælger, inklusive skift mellem sommer- og vintertid: Ved skiftet om foråret kan et job, der er sat til 2.30, blive sprunget over, og om efteråret kan det køre én eller to gange alt efter implementeringen. Til job, der skal køre præcis én gang, bør du vælge tidspunkter uden for kl. 1.00–3.00 eller bruge UTC.

Vixie cron, systemd-timere, Quartz og AWS

• systemd-timere bruger OnCalendar= med en anden syntaks: Mon..Fri *-*-* 09..17:00/15:00. Betingelser for ugedag og dato kombineres med OG, ikke ELLER, så nogle cron-udtryk har ingen præcis ækvivalent.
• Quartz og Spring sætter et sekundfelt først og kan tilføje et årsfelt. Et af de to dagfelter skal være ?, og Quartz nummererer ugedage 1–7 fra søndag, i modsætning til crons 0–6. Værktøjet skriver ugedage som navne (MON-FRI) for at undgå den fælde.
• AWS EventBridge bruger cron(minutter timer dag måned ugedag år): seks felter, ingen sekunder, et ? i det ene dagfelt og et år til sidst.

Standard cron har intet sekundfelt. Formen med 6 felter og sekunder understøttes af mange biblioteker (node-cron, Spring, Quartz), men ikke af systemets crontab.