What is a cron expression?

A cron expression is a string of 5 (or 6) fields that defines a recurring schedule for automated tasks. The fields represent minute, hour, day-of-month, month, and day-of-week. For example, '0 9 * * 1-5' means 'at 09:00 on every weekday'. Cron is used in Linux crontab, GitHub Actions, AWS EventBridge, Kubernetes CronJobs, and most task schedulers.

What does each field in a cron expression mean?

A standard 5-field cron expression is: [minute] [hour] [day-of-month] [month] [day-of-week]. Each field accepts numbers, ranges (1-5), step values (*/15), lists (1,3,5), or * for 'any'. For example: '*/15 * * * *' = every 15 minutes; '0 0 * * 0' = midnight every Sunday; '30 8 1 * *' = 8:30 AM on the 1st of every month.

What is the difference between a cron expression and a cron schedule?

The terms are often used interchangeably. A 'cron expression' usually refers to the raw string (e.g., '0 9 * * 1-5'), while a 'cron schedule' may refer to the complete definition including the command and environment. Some systems like AWS and Spring use a 6-field or 7-field variant that adds a seconds field or a year field.

How do I write a cron expression to run every 5 minutes?

Use '*/5 * * * *' to run every 5 minutes. The */5 step notation divides the minute field (0-59) into intervals of 5. Similarly: '*/10 * * * *' = every 10 minutes, '0 * * * *' = every hour on the hour, '0 0 * * *' = once per day at midnight, '0 9-17 * * 1-5' = every hour during business hours on weekdays.

Cron izteiksmes parsētājs

Iekļaut sekundes:Izslēgts

Nākamie ieplānotie datumi:

Izvades formāts:

Parsējamā Cron izteiksme

Formāts: minūte (0-59) stunda (0-23) diena (1-31) mēnesis (1-12) nedēļas diena (0-6, 0=svētdiena)

Piemēri

Tehniskā informācija

Kā darbojas Cron izteiksmes parsētājs

Ko rīks dara

Cron izteiksmes parsētājs interpretē cron izteiksmes un pārvērš tās cilvēkam saprotamos aprakstos un ieplānotos izpildes laikos. Šis cron parsētājs darbojas gan kā cron izteiksmju tulkotājs, cron izteiksmju ģenerators un cron grafika ģenerators, palīdzot izstrādātājiem saprast, kad cron darbi tiks izpildīti. Ja nepieciešams parsēt cron izteiksmes vai pārvērst cron cilvēkam saprotamā formātā, šis rīks sniedz tūlītējus rezultātus. Parsētājs atbalsta standarta 5 lauku cron izteiksmes (minūte, stunda, mēneša diena, mēnesis, nedēļas diena) un 6 lauku izteiksmes, kas ietver sekundes. Tas aprēķina nākamās ieplānotās izpildes reizes, balstoties uz pašreizējo laiku, un parāda tās lasāmā formātā. Cron validators pārbauda sintaksi un sniedz detalizētus aprakstus par to, kad darbi tiks izpildīti. Šis crontab parsētājs palīdz izstrādātājiem pārbaudīt cron izteiksmes pirms to izvietošanas ražošanas sistēmās.

Biežākie izstrādātāju lietošanas gadījumi

Izstrādātāji izmanto cron parsētājus, konfigurējot ieplānotus uzdevumus, atkļūdojot cron darbu problēmas vai izprotot esošas cron izteiksmes kodu bāzēs. Cron izteiksmes parsētājs un cron izteiksmes ģenerators palīdz pārbaudīt, vai cron izteiksmes ir pareizas pirms to izvietošanas ražošanā. Daudzi izstrādātāji izmanto cron parsētājus, lai sarežģītas izteiksmes pārtulkotu cilvēkam saprotamos aprakstos, padarot vieglāk saprotamu, kad darbi tiks palaisti. Crontab parsētājs ir vērtīgs sistēmu administrēšanā, CI/CD cauruļvados, ieplānotās dublējumkopijās vai automatizētos uzdevumos. Izstrādātāji to izmanto, lai validētu cron izteiksmes, aprēķinātu cron nākamās palaišanas laikus vai ģenerētu cron izteiksmes konkrētām plānošanas prasībām. Rīks palīdz, atkļūdojot, kāpēc cron darbs netika palaists, kā gaidīts, vai dokumentējot ieplānotus uzdevumus.

Datu formāti, tipi vai varianti

Cron izteiksmes izmanto ar atstarpēm atdalītu formātu ar 5 vai 6 laukiem, kas attēlo laika vienības. Standarta 5 lauku formāts ir: minūte (0-59), stunda (0-23), mēneša diena (1-31), mēnesis (1-12) un nedēļas diena (0-6, kur 0 ir svētdiena). 6 lauku formāts sākumā pievieno sekundes (0-59). Katrs lauks atbalsta aizstājējzīmes (*), diapazonus (1-5), sarakstus (1,3,5) un soļa vērtības (*/5). Dažas sistēmas izmanto 5 laukus, dažas 6 (ar sekundēm), un Quartz stila cron atšķiras no standarta Unix cron. Šis parsētājs seko standarta Unix cron semantikai; ja jūsu izteiksme darbojas citur, bet ne šeit, tā var būt dialekta atšķirība.

Biežākie cron izteiksmju piemēri:

0 9 * * 1-5 — plkst. 9:00 darba dienās
*/15 * * * * — ik pēc 15 minūtēm
0 0 * * 0— katru svētdienu pusnaktī
0 0 1 * *— katra mēneša pirmajā dienā

Parsētājs apstrādā šīs variācijas un attiecīgi aprēķina nākamos izpildes laikus.

Biežākās kļūdas un robežgadījumi

Viena bieža kļūda ir sajaukt nedēļas dienu numerāciju: šis parsētājs izmanto 0-6 (svētdiena–sestdiena, kur 0 ir svētdiena), kamēr dažas sistēmas izmanto 1-7 (pirmdiena–svētdiena). Vēl viena problēma ir laika joslu apstrāde: cron izteiksmes parasti tiek vērtētas servera laika joslā, kas var atšķirties no jūsu lokālās laika joslas. Mēneša diena un nedēļas diena izmanto VAI semantiku: ja abi ir norādīti (nevis *), darbs tiek palaists, kad ir patiess jebkurš no nosacījumiem, kas var mulsināt. Piemēram, izteiksme 0 9 15 * 1 tiek palaista plkst. 9:00 katra mēneša 15. datumā VAI katru pirmdienu, nevis tikai tad, kad abi nosacījumi ir izpildīti. Mēnešu robežas var radīt problēmas: cron darbs, kas ieplānots 31. datumā, netiks palaists mēnešos ar mazāk dienām. Parsētājs apstrādā šos robežgadījumus, taču izstrādātājiem jāapzinās laika joslu atšķirības un datumu robežnosacījumi. Garie gadi un pārejas uz vasaras/ziemas laiku arī var ietekmēt ieplānotos izpildes laikus. Izmantojot soļa vērtības ar diapazoniem, pārliecinieties, ka solis vienmērīgi dalās diapazonā, lai izvairītos no negaidītas uzvedības.

Kad izmantot šo rīku, nevis kodu

Izmantojiet šo cron parsētāju ātrai izteiksmju validācijai, esošo cron darbu izpratnei vai cilvēkam saprotamu aprakstu ģenerēšanai. Tas ir ideāli piemērots cron darbu problēmu atkļūdošanai, ieplānoto uzdevumu dokumentēšanai vai cron izteiksmju sintakses apguvei. Ražošanas kodā izmantojiet cron parsēšanas bibliotēkas, kas ir integrētas jūsu lietotnē un var validēt izteiksmes, aprēķināt nākamās palaišanas laikus un integrēties ar darbu plānošanas sistēmām. Cron bibliotēkas nodrošina labāku kļūdu apstrādi, laika joslu atbalstu un integrāciju ar uzdevumu plānotājiem. Pārlūkprogrammas rīki izceļas ad-hoc parsēšanā un mācībās, savukārt uz kodu balstīti risinājumi nodrošina automatizāciju, validāciju CI/CD cauruļvados un integrāciju ar darbu plānošanas ietvariem. Uzņēmuma līmeņa plānošanas sistēmām vietējās bibliotēkas piedāvā labāku veiktspēju, laika joslu apstrādi un atbalstu uzlabotām cron iespējām.