WebGroundwebground.app
Info & Gidsen · Ontwikkelaarsnaslag

Cron-Expressies: Gids & Parser voor Schema's

Begrijp de syntaxis van cron-schema's aan de hand van veelgebruikte voorbeelden en plak een expressie van vijf velden om die te controleren en de volgende uitvoertijden te zien.

Controleer een cron-expressie

Vijf velden, gescheiden door spaties: minuut, uur, dag van de maand, maand, dag van de week.

Geldige cron-expressie

Uitleg per veld

  • Minuut

    Toegestaan: 0 tot en met 59

    Waarde
    */15
    Komt overeen met
    • 0
    • 15
    • 30
    • 45
  • Uur

    Toegestaan: 0 tot en met 23

    Waarde
    9-17
    Komt overeen met
    • 9 tot en met 17
  • Dag van de maand

    Toegestaan: 1 tot en met 31

    Waarde
    *
    Komt overeen met
    Elke dag van de maand
  • Maand

    Toegestaan: 1 tot en met 12

    Waarde
    *
    Komt overeen met
    Elke maand
  • Dag van de week

    Toegestaan: 0 tot en met 7

    Waarde
    MON-FRI
    Komt overeen met
    • maandag tot en met vrijdag

Volgende uitvoertijden

Veelgebruikte schema's

  • * * * * *
    Wanneer het draait
    Elke minuut
    Verkorte notatie
  • */5 * * * *
    Wanneer het draait
    Elke 5 minuten
    Verkorte notatie
  • */30 * * * *
    Wanneer het draait
    Elke 30 minuten
    Verkorte notatie
  • 0 * * * *
    Wanneer het draait
    Elk uur, op het hele uur
    Verkorte notatie
    @hourly
  • 0 */6 * * *
    Wanneer het draait
    Elke 6 uur, te beginnen om middernacht
    Verkorte notatie
  • 0 0 * * *
    Wanneer het draait
    Elke dag om middernacht
    Verkorte notatie
    @daily
  • 30 8 * * *
    Wanneer het draait
    Elke dag om 8:30 uur 's ochtends
    Verkorte notatie
  • 0 9 * * 1-5
    Wanneer het draait
    Maandag tot en met vrijdag om 9:00 uur 's ochtends
    Verkorte notatie
  • 0 0 * * 0
    Wanneer het draait
    Elke zondag om middernacht
    Verkorte notatie
    @weekly
  • 0 0 1 * *
    Wanneer het draait
    Om middernacht op de eerste dag van elke maand
    Verkorte notatie
    @monthly
  • 0 0 1 */3 *
    Wanneer het draait
    Om middernacht op de eerste dag van januari, april, juli en oktober
    Verkorte notatie
  • 0 0 1 1 *
    Wanneer het draait
    Elk jaar om middernacht op 1 januari
    Verkorte notatie
    @yearly

Speciale tekens

  • *
    Betekenis
    Elke waarde van het veld.
    Voorbeeld
    * * * * *
  • ,
    Betekenis
    Een lijst met losse waarden.
    Voorbeeld
    0 9,18 * * *
  • -
    Betekenis
    Een bereik van waarden, inclusief beide uiteinden.
    Voorbeeld
    0 9-17 * * *
  • /
    Betekenis
    Een stap: elke n-de waarde, geteld vanaf het begin van het bereik.
    Voorbeeld
    */10 * * * *

Zo is een cron-expressie opgebouwd

Een cron-expressie bestaat uit vijf velden, gescheiden door spaties: minuut, uur, dag van de maand, maand en dag van de week. Elk veld geeft aan wanneer de taak mag draaien, en de taak draait op elke minuut waarop alle velden overeenkomen.

Een veld kan één getal zijn, een sterretje voor elke waarde, een lijst met komma's, een bereik met een koppelteken of een stap met een schuine streep. Maanden en weekdagen kun je ook schrijven als Engelse namen van drie letters, zoals JAN of MON.

Wat er vaak misgaat

Een schema dat er goed uitziet, kan toch op onverwachte momenten draaien.

  • Cron gebruikt de tijdzone van de server, en die kan anders zijn dan de jouwe. De uitvoertijden hierboven gebruiken de tijdzone van je apparaat.
  • Als zowel de dag van de maand als de dag van de week is ingesteld, draait de taak zodra een van de twee overeenkomt.
  • In het veld voor de dag van de week betekenen zowel 0 als 7 zondag.
  • Een stap zoals */7 begint opnieuw bij elk nieuw uur, elke nieuwe dag of elke nieuwe maand, dus de tussenpozen zijn niet altijd gelijk.

Veelgestelde vragen (FAQ)

Waarom wordt mijn expressie met zes velden afgewezen?+

Standaard-cron op Linux en macOS gebruikt vijf velden. Expressies met zes of zeven velden komen van Quartz, Spring en vergelijkbare taakplanners, die een secondenveld en soms een jaar toevoegen en extra tekens gebruiken, zoals ? en L.

Wat betekenen verkorte notaties zoals @daily?+

Het zijn korte namen voor veelgebruikte schema's. @hourly, @daily, @weekly, @monthly en @yearly draaien aan het begin van elk uur, elke dag, elke week, elke maand of elk jaar. @reboot draait één keer bij het opstarten en heeft dus geen uitvoertijden om te tonen.

Wordt de expressie die ik typ ergens naartoe gestuurd?+

Nee. De expressie wordt in je browser gecontroleerd en ook de uitvoertijden worden daar berekend.

Ontdek meer WebGround-tools

Alles bekijken