Crontab generator & cron-uitdrukking bouwen

Wat is een cron-uitdrukking?

# Linux crontab entry — runs every 15 minutes
*/15 * * * *  /usr/local/bin/poll-api.sh

# Kubernetes CronJob — weekdays at 9:00 AM UTC
apiVersion: batch/v1
kind: CronJob
metadata:
  name: daily-report
spec:
  schedule: "0 9 * * 1-5"
  timeZone: "UTC"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: report
              image: report-runner:1.0
          restartPolicy: OnFailure

# GitHub Actions workflow — hourly
on:
  schedule:
    - cron: '0 * * * *'

# AWS EventBridge — first of each month
ScheduleExpression: cron(0 0 1 * ? *)
# (Note: AWS uses the Quartz 6-field form with '?' for day-of-week)

Belangrijkste functies

Cron-varianten & schedulers

Voorbeelden van cron-uitdrukkingen

*/15 * * * *

0 9 * * 1-5

0 0 1 * *

*/5 9-17 * * 1-5

0 0 1 JAN,APR,JUL,OCT *

0 0 1 * 5

30 2 * * *

@daily

Zo bouw je een cron-uitdrukking

1. 1

   Typ of plak een cron-uitdrukking

   Voer een vijf-veld cron-uitdrukking in het invoerveld hierboven (bijv. `*/15 * * * *`). De tool ontleedt en valideert terwijl je typt — groen vinkje voor geldig, rode fout met veldnaam voor ongeldig. Macro's zoals `@daily`, `@hourly`, enz. worden ook geaccepteerd.

2. 2

   Of pas de vijf veldinvoeren aan

   Geen veld-volgorde onthouden — bewerk Minuut, Uur, Dag-van-de-maand, Maand of Dag-van-de-week los van elkaar via de gelabelde invoervelden. De volledige uitdrukking bovenaan updatet automatisch. Gebruik `*` voor wildcards, `*/N` voor stappen, `a-b` voor bereiken en `1,3,5` voor lijsten.

3. 3

   Kies een preset als startpunt

   Tik op een preset (Elke 15 minuten, Doordeweeks om 9:00 uur, enz.) om een gangbare planning te laden, en pas daarna de velden aan tot het exact past. Elf presets dekken de patronen die je daadwerkelijk in productie gebruikt.

4. 4

   Verifieer de preview van de volgende run

   Bekijk de vijf aankomende runtijden — wissel tussen Lokaal en UTC om te bevestigen dat de planning afgaat wanneer je het bedoelt. Dit is de betrouwbaarste manier om de POSIX dag-van-de-maand / dag-van-de-week OR-valkuil te vangen voordat hij je in productie bijt.

5. 5

   Kopieer en plak in je scheduler

   Klik op Kopiëren om de uitdrukking op te halen. Plak in je crontab, systemd-timer, GitHub Actions `cron:`, AWS EventBridge, Kubernetes CronJob `schedule` of een andere cron-compatibele scheduler. Vergeet niet de tijdzone van de doel-scheduler te controleren — zie de sectie Aanbevolen aanpak hieronder.

Veelgemaakte cron-fouten

# Bedoeld: "eerste vrijdag van de maand"
0 0 1-7 * 5
# Werkelijk: gaat af op dag 1-7 van de maand ÓF elke vrijdag — beide condities

# Gebruik wrapper voor echte AND-semantiek
0 0 * * 5  [ $(date +\%d) -le 7 ] && /jouw-script
# OF laat één conditie vallen en accepteer de ruimere planning

# Geschreven door US East-dev, gedeployed op UTC-server
0 9 * * *  /jouw-rapport.sh
# Gaat af om 9:00 UTC = 4:00 US East — niet wat de dev bedoelde

# Zet tijdzone vast, of schrijf expliciet in UTC
CRON_TZ=America/New_York
0 9 * * *  /jouw-rapport.sh

# Bedoeld: elke 15 minuten
15 * * * *
# Werkelijk: één keer per uur, op minuut 15 (4 runs/uur minder dan bedoeld)

# Correct
*/15 * * * *
# Elke 15 minuten: minuut 0, 15, 30, 45 van elk uur

# Quartz 6-veld gekopieerd naar Linux crontab
0 0 9 * * 1-5
# Linux leest: minuut=0, uur=0, dom=9, maand=*, dow=1-5
# = middernacht op dag 9 in maanden die overeenkomen met doordeweekse dagen — chaos

# POSIX 5-veld, laat de seconden weg
0 9 * * 1-5
# = doordeweeks om 9:00 uur

# 30 of 31 februari — draait nooit
0 0 30 2 *
0 0 31 2 *
# Ontleedt maar er gaat geen planning ooit af

# Gebruik patroon 'laatste werkdag van februari' via script
0 0 28-29 2 *  [ $(date -d tomorrow +\%m) = 03 ] && /jouw-script

# Quartz: 'laatste vrijdag van de maand' — ongeldig in POSIX
0 0 ? * 6L *

# POSIX wrapper-script aanpak voor laatste-vrijdag
0 0 25-31 * 5  /jouw-script
# Draait op vrijdag tussen de 25e en 31e van elke maand

Veelvoorkomende use cases

Linux crontab-jobs

Bouw en verifieer regels voor `/etc/crontab`, `/etc/cron.d/*` of per-gebruiker `crontab -e` bestanden. Gebruik de preview van de volgende run om te bevestigen dat de planning op het juiste tijdstip valt in de geconfigureerde tijdzone van je server voordat je opslaat.

Kubernetes CronJob-planningen

Genereer het `spec.schedule` veld voor een Kubernetes CronJob. Kubernetes 1.27+ ondersteunt ook `spec.timeZone` — gebruik de UTC-toggle om je planning in UTC te ontwerpen en zet daarna `timeZone` expliciet om de lokale tijd van de worker-node te omzeilen.

GitHub Actions geplande workflows

Bouw de `cron:` regel onder `on.schedule`. GitHub Actions draait altijd in UTC — zet de preview op UTC om je planning te bevestigen. Vermijd intervallen korter dan 15 minuten; de scheduler van GitHub slaat korte-interval-jobs onder belasting over.

AWS EventBridge rules

Stel de cron-uitdrukking samen voor een EventBridge geplande rule. Let op: AWS gebruikt Quartz-achtige zes-veld syntaxis met `?` voor dag-van-de-week — deze tool produceert POSIX vijf-veld, die je moet omzetten door seconden (`0`) voorop te zetten en de `*` in één van de twee dag-velden te vervangen door `?`.

GitLab CI geplande pipelines

Verifieer de cron-uitdrukking voor een geplande CI-pipeline in GitLab. GitLab gebruikt POSIX vijf-veld syntaxis — wat deze tool produceert — en een UI-datumkiezer, maar de cron-vorm geeft je fijnere controle voor niet-standaard intervallen.

Cloudflare Workers Cron Triggers

Bouw de `[triggers.crons]` regel in `wrangler.toml`. Cloudflare gebruikt POSIX vijf-veld syntaxis. Minimum interval is één minuut; de worker draait in UTC. Gebruik de preview om te verifiëren dat de trigger binnen je verwachte venster afgaat.

Node.js node-cron planningen

Bouw uitdrukkingen voor de `node-cron` bibliotheek, die zowel vijf-veld POSIX als een optioneel voorafgaand seconden-veld ondersteunt. Houd het op vijf velden tenzij je specifiek sub-minute precisie nodig hebt — zes-veld uitdrukkingen porten niet naar Linux crontab.

Code review en documentatie

Plak een cron-uitdrukking uit een PR of runbook om direct te zien wat hij doet — geen gokken meer bij `30 7 * * 1-5` of het erbij pakken van een referentiekaart. De uitleg in begrijpelijke taal is ook geweldig voor inline-opmerkingen en README-bestanden.

Cron-syntaxis referentie

Veldvolgorde: M U D M W

Minuut (0-59), Uur (0-23), Dag-van-de-maand (1-31), Maand (1-12), Dag-van-de-week (0-6, waarbij 7 ook = zondag). Het dag-van-de-week veld accepteert zowel numerieke (0-6) als benoemde (SUN-SAT, hoofdletterongevoelig) tokens.

Operatoren

`*` = elke waarde; `,` = lijstscheider (`1,3,5`); `-` = bereik (`1-5`); `/` = stap (`*/15`, `5/10`); namen: JAN-DEC voor maand, SUN-SAT voor dag-van-de-week (hoofdletterongevoelig).

Macro's (aliassen)

`@yearly` = `0 0 1 1 *`; `@annually` = `0 0 1 1 *`; `@monthly` = `0 0 1 * *`; `@weekly` = `0 0 * * 0`; `@daily` = `0 0 * * *`; `@midnight` = `0 0 * * *`; `@hourly` = `0 * * * *`. `@reboot` is een speciaal non-schedule (draait alleen bij boot) en wordt afgewezen met een toelichtende fout.

POSIX dag-semantiek (OR-regel)

Wanneer ZOWEL dag-van-de-maand ALS dag-van-de-week beperkt zijn (geen van beide is `*`), draait de planning wanneer ÉÉN van beide matcht — OR-semantiek. Als slechts één beperkt is, beslist die. Zijn beide `*`, dan matcht elke dag. Deze OR-regel geldt voor vixie cron, BSD cron en de meeste POSIX-implementaties; Quartz gebruikt `?` om AND versus OR te disambigueren.

Zes-veld modus (Quartz-Lite)

Heeft je invoer zes door spaties gescheiden tokens, dan behandelt de tool de eerste als seconden-veld (0-59). Handig voor Quartz, Spring `@Scheduled(cron=...)` en node-cron. NIET portable naar Linux crontab of POSIX-schedulers — die zouden je seconden als minuten interpreteren en alles één positie opschuiven.

Verankering van de stap-operator

`*/N` is verankerd aan de laagste waarde van het veld: `*/15` in minuut = `0,15,30,45`, niet "elke 15 vanaf nu". Met een niet-wildcard basis: `5/15` in minuut = `5,20,35,50`. Stap-waarden die het veldbereik niet gelijkmatig delen slaan er bij de wraparound één over — dat is correct, geen bug.

Validatiegrenzen

minuut ∈ [0,59], uur ∈ [0,23], dag-van-de-maand ∈ [1,31], maand ∈ [1,12], dag-van-de-week ∈ [0,7]. Waarden buiten bereik produceren een fout op veldniveau. De dag-van-de-maand wordt NIET gevalideerd tegen de maand (`0 0 31 2 *` ontleedt prima maar matcht nooit, want februari heeft geen dag 31 — de preview van de volgende run toont "Geen geplande runs").

Quartz-operatoren afgewezen

POSIX cron ondersteunt niet de Quartz-operatoren `?` (geen specifieke waarde), `L` (laatste), `W` (dichtstbijzijnde werkdag) of `#` (n-de weekdag). Deze tool wijst ze af met een duidelijke melding "Quartz-operatoren niet ondersteund" in plaats van ze stilzwijgend te ontleden als ongeldige POSIX. Voor Quartz-planningen gebruik je een Quartz-bewuste tool of de Spring scheduler.

Jaar-cap op zoektocht naar volgende run

De berekening van de volgende run zoekt tot 4 jaar vooruit; uitdrukkingen die minder vaak matchen (bijv. "29 feb" patronen) tonen "Geen geplande runs binnen de komende 4 jaar". Dit is bewust om onbegrensde iteratie op onmogelijke patronen te voorkomen.

Aanbevolen aanpak voor cron-planningen

Gebruik UTC op servers, converteer pas bij weergave

Zet je servers op UTC (`/etc/timezone` of `TZ=UTC`) en schrijf alle cron-uitdrukkingen in UTC. Converteer pas naar lokale tijd op het moment van weergave in je dashboards en rapporten. Dit elimineert een hele categorie tijdzone-bugs die het hardst toeslaan bij zomertijd-overgangen, wanneer lokale-tijd planningen stilzwijgend dubbel afgaan of een run overslaan. Gebruik de UTC-toggle in deze tool om je planning vanaf het begin in UTC te ontwerpen.

Vermijd de POSIX dag-van-de-maand/dag-van-de-week OR-val

Beperk nooit zowel dag-van-de-maand ALS dag-van-de-week tenzij je OR-semantiek wilt. Wil je "elke maandag in januari", schrijf dan `0 0 * 1 1` (dag-van-de-maand is `*`); wil je "de 1e van elke maand", schrijf dan `0 0 1 * *` (dag-van-de-week is `*`). De POSIX OR-regel betekent dat `0 0 1 * 1` draait op de 1e ÉN elke maandag — vrijwel zeker niet wat je bedoelde. De preview van de volgende run vangt dit op als je vóór deploy checkt.

Zet de tijdzone van de planning expliciet vast

Moderne schedulers ondersteunen het vastpinnen van de tijdzone in de planningsdefinitie: `CRON_TZ=America/New_York` bovenaan een crontab (vixie cron 3.0+), `spec.timeZone: "America/New_York"` voor Kubernetes CronJobs 1.27+, schedule expression met `ScheduleExpressionTimezone` voor AWS EventBridge Scheduler. Zet de tijdzone expliciet vast in plaats van te leunen op de default van de server — server-tijdzones kunnen zonder waarschuwing veranderen tijdens infrastructuurmigraties.

Spreid belasting over de minuten, niet op :00

Vermijd `0 * * * *` (elk uur op minuut 0) voor niet-kritieke jobs — op schaal levert veel dingen plannen op exact :00 belastingspieken op. Kies een willekeurige minuut-offset (`23 * * * *`, `41 * * * *`) voor elke job om de belasting te spreiden. Hetzelfde geldt voor dagelijkse jobs: `30 3 * * *` is vriendelijker voor je database dan `0 3 * * *` wanneer veel jobs samenkomen om 3:00.

Maak jobs idempotent

Cron heeft geen ingebouwde retry, geen overlap-preventie, geen herstel van gemiste runs. Je job moet veilig meerdere keren uit te voeren zijn (idempotent) en zichzelf controleren. In plaats van "verstuur rapport om 9:00 uur" ontwerp je hem als "verstuur het rapport van vandaag als dat nog niet is verzonden" — zo herstelt hij vanzelf na downtime, per ongeluk dubbele planningen en gelijktijdige runs. Idempotentie is een eigenschap van de job, niet van de scheduler, en het is de allerbelangrijkste betrouwbaarheidspraktijk.

Voeg een heartbeat toe voor kritieke planningen

De stille-storing-modus van cron is zijn grootste zwakte — als de planning niet afgaat, krijg je nergens een signaal. Voor kritieke jobs laat je de job aan het einde van elke run een heartbeat-service pingen (Healthchecks.io, Cronitor, Dead Man's Snitch); de service alarmeert je als de verwachte ping uitblijft. Zo vang je zowel een falende job als een misvurende planning op. De gratis tier dekt de meeste persoonlijke en small-team behoeften.

Verifieer met de preview van de volgende run voor je ship

Voordat je een nieuwe cron-planning deployt, bekijk je de vijf aankomende runtijden in de preview van deze tool. Wissel tussen Lokaal en UTC. Bevestig dat de planning valt waar je het bedoelt — niet vijf minuten te vroeg, niet op de verkeerde dag, niet over het weekend heen dat je belangrijk vond. De preview is de goedkoopst mogelijke productietest.

Veelgestelde vragen