Cron-expressieparser

Wat elk veld allemaal selecteert

Een veld is niet één waarde, het is een verzameling. Weten hoe groot die verzameling is, beantwoordt meestal meteen de vraag waarmee je kwam.

Operatoren binnen een veld: * voor elke waarde, 1,5,10 voor een lijst, 1-5 voor een bereik, */15 voor een stap geteld vanaf het begin van het bereik en 0-45/15 voor een stap binnen een bereik.

Namen en verkorte notaties worden geaccepteerd

Namen van maanden en dagen van de week worden herkend en uitgeschreven tot de nummers waar ze voor staan, dus 30 3 * JAN,JUL 1 meldt maand 1, 7 en dag van de week 1. De verkorte notaties worden nog vóór al het andere uitgeschreven tot hun vorm met 5 velden:

@reboot wordt ook herkend, maar heeft geen schema om uit te schrijven: die draait eenmalig bij het opstarten van de machine, dus er valt geen uitvoeringstijd te tonen.

Waarschuwingen die je echt moet lezen

• Allebei de dagvelden ingeperkt. 0 0 1 * MON betekent niet “de 1e, maar alleen als het een maandag is”. Standaard cron behandelt de twee dagvelden als OF zodra ze allebei zijn ingeperkt, dus die regel draait op de 1e van elke maand én op elke maandag. De parser waarschuwt daarvoor, en de uitvoeringstijden volgen diezelfde OF-regel.
• Een datum die nooit voorkomt. 0 0 30 2 * vraagt om 30 februari. De expressie is syntactisch geldig en cron accepteert hem, maar hij wordt nooit uitgevoerd. De parser zegt dat erbij, in plaats van je een lege lijst zonder uitleg voor te schotelen.
• Quartz-operatoren. L (laatste), W (dichtstbijzijnde werkdag), # (de zoveelste weekdag van de maand) en ? zijn uitbreidingen van Quartz, geen standaard crontab. In een regel met 5 velden worden ze herkend en gemarkeerd, en het veld laat zien dat het om een Quartz-operator gaat in plaats van om een lijst met waarden. Er worden geen uitvoeringstijden berekend, want standaard cron zou die regel überhaupt niet draaien.

Wat meteen wordt afgewezen

• Het verkeerde aantal velden. Een Quartz-regel met 6 velden (met seconden) of 7 velden (met jaartal) wordt afgewezen op het aantal velden.
• Waarden buiten het bereik, bijvoorbeeld minuut 75 of maand 13.
• Een aflopend bereik zoals 5-1.
• Een stapgrootte van 0, zoals */0.

Elke afwijzing noemt het veld en de waarde die de fout veroorzaakt, zodat je één ding aanpast in plaats van de hele regel opnieuw te schrijven.

Tijdzone

De volgende uitvoeringstijden worden in je browser berekend, in de tijdzone die op je apparaat staat ingesteld. Een crontab draait in de tijdzone van de machine waarop hij staat, dus als die server op UTC staat en jij niet, verschuif de tijden dan voordat je ze vergelijkt.