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-lausekkeen jäsennin

Sisällytä sekunnit:Pois päältä

Seuraavat ajoitetut päivämäärät:

Tulostusmuoto:

Jäsennettävä cron-lauseke

Muoto: minuutti (0-59) tunti (0-23) päivä (1-31) kuukausi (1-12) viikonpäivä (0-6, 0=sunnuntai)

Esimerkit

Tekniset tiedot

Miten Cron-lausekkeen jäsentäjä toimii

Mitä työkalu tekee

Cron-lausekkeen jäsentäjä tulkitsee cron-lausekkeita ja muuntaa ne selkokielisiksi kuvauksiksi ja ajastetuiksi suoritusaikatauluiksi. Tämä cron-jäsentäjä toimii sekä cron-lausekkeen kääntäjänä, cron-lausekkeen generaattorina että cron-aikataulugeneraattorina, auttaen kehittäjiä ymmärtämään, milloin cron-työt suoritetaan. Kun sinun täytyy jäsentää cron-lausekkeita tai muuntaa cron selkokieliseen muotoon, tämä työkalu antaa välittömät tulokset. Jäsentäjä tukee standardeja 5-kenttäisiä cron-lausekkeita (minuutti, tunti, kuukauden päivä, kuukausi, viikonpäivä) sekä 6-kenttäisiä lausekkeita, joissa on mukana sekunnit. Se laskee seuraavat ajastetut ajot nykyisen ajan perusteella ja näyttää ne luettavassa muodossa. Cron-validaattori tarkistaa syntaksin ja antaa yksityiskohtaiset kuvaukset siitä, milloin työt suoritetaan. Tämä crontab-jäsentäjä auttaa kehittäjiä varmistamaan cron-lausekkeet ennen niiden viemistä tuotantojärjestelmiin.

Yleiset kehittäjien käyttötapaukset

Kehittäjät käyttävät cron-jäsentäjiä ajastettujen tehtävien konfiguroinnissa, cron-työongelmien debuggaamisessa tai olemassa olevien cron-lausekkeiden ymmärtämisessä koodikannoissa. Cron-lausekkeen jäsentäjä ja cron-lausekkeen generaattori auttavat varmistamaan, että lausekkeet ovat oikein ennen tuotantoon viemistä. Monet kehittäjät käyttävät cron-jäsentäjiä monimutkaisten lausekkeiden kääntämiseen selkokielisiksi kuvauksiksi, jolloin on helpompi ymmärtää, milloin työt ajetaan. Crontab-jäsentäjä on arvokas järjestelmänhallinnassa, CI/CD-putkissa, ajastetuissa varmuuskopioissa tai automatisoiduissa tehtävissä. Kehittäjät käyttävät sitä cron-lausekkeiden validointiin, seuraavien ajoaikojen laskemiseen tai cron-lausekkeiden luomiseen tiettyihin ajastusvaatimuksiin. Työkalu auttaa, kun selvitetään, miksi cron-työ ei ajautunut odotetusti tai kun ajastettuja tehtäviä dokumentoidaan.

Tietomuodot, tyypit tai variantit

Cron-lausekkeet käyttävät välilyönneillä erotettua formaattia, jossa on 5 tai 6 kenttää ajan yksiköille. Standardi 5-kenttäinen formaatti on: minuutti (0–59), tunti (0–23), kuukauden päivä (1–31), kuukausi (1–12) ja viikonpäivä (0–6, jossa 0 on sunnuntai). 6-kenttäinen formaatti lisää alkuun sekunnit (0–59). Jokainen kenttä tukee jokerimerkkejä (*), alueita (1-5), listoja (1,3,5) ja askelarvoja (*/5). Jotkin järjestelmät käyttävät 5 kenttää, jotkin 6 (sekunnit mukana), ja Quartz-tyylinen cron poikkeaa standardista Unix-cronista. Tämä jäsentäjä noudattaa standardin Unix-cronin semantiikkaa; jos lausekkeesi toimii muualla mutta ei täällä, kyse voi olla murre-erosta.

Yleisiä cron-lauseke-esimerkkejä:

0 9 * * 1-5 — klo 9:00 arkipäivisin
*/15 * * * * — 15 minuutin välein
0 0 * * 0— joka sunnuntai keskiyöllä
0 0 1 * *— jokaisen kuukauden ensimmäinen päivä

Jäsentäjä käsittelee nämä variaatiot ja laskee seuraavat suorituskerrat sen mukaisesti.

Yleiset sudenkuopat ja reunatapaukset

Yksi yleinen virhe on sekoittaa viikonpäivien numerointi: tämä jäsentäjä käyttää 0–6 (sunnuntai–lauantai, jossa 0 on sunnuntai), kun taas jotkin järjestelmät käyttävät 1–7 (maanantai–sunnuntai). Toinen ongelma liittyy aikavyöhykkeisiin: cron-lausekkeet arvioidaan tyypillisesti palvelimen aikavyöhykkeessä, joka voi poiketa paikallisesta aikavyöhykkeestäsi. Kuukauden päivä ja viikonpäivä käyttävät OR-semanttiikkaa: jos molemmat on määritetty (ei *), työ ajetaan, kun jompikumpi ehto täyttyy, mikä voi olla hämmentävää. Esimerkiksi lauseke 0 9 15 * 1 ajetaan klo 9 joka kuukauden 15. päivänä TAI joka maanantai, ei vain silloin kun molemmat ehdot täyttyvät. Kuukauden vaihteet voivat aiheuttaa ongelmia: 31. päivälle ajastettu cron-työ ei ajaudu kuukausina, joissa on vähemmän päiviä. Jäsentäjä käsittelee nämä reunatapaukset, mutta kehittäjien on hyvä tiedostaa aikavyöhyke-erot ja päivämäärärajoihin liittyvät ehdot. Karkausvuodet ja kesäaikasiirtymät voivat myös vaikuttaa ajastettuihin suoritusaikoihin. Kun käytät askelarvoja alueiden kanssa, varmista, että askel jakautuu tasan alueeseen, jotta vältyt odottamattomalta käytökseltä.

Milloin käyttää tätä työkalua vs. koodia

Käytä tätä cron-jäsentäjää nopeaan lausekkeiden validointiin, olemassa olevien cron-töiden ymmärtämiseen tai selkokielisten kuvausten generointiin. Se sopii erinomaisesti cron-työongelmien debuggaamiseen, ajastettujen tehtävien dokumentointiin tai cron-syntaksin opetteluun. Tuotantokoodissa käytä sovellukseesi integroitavia cron-jäsentämiskirjastoja, jotka voivat validoida lausekkeet, laskea seuraavat ajoajat ja integroitua työnajastusjärjestelmiin. Cron-kirjastot tarjoavat paremman virheenkäsittelyn, aikavyöhyketuen ja integraation tehtäväajastimiin. Selainpohjaiset työkalut ovat parhaimmillaan ad hoc -jäsentämisessä ja oppimisessa, kun taas koodipohjaiset ratkaisut tarjoavat automaation, validoinnin CI/CD-putkissa ja integraation työnajastuskehyksiin. Yritystason ajastusjärjestelmissä natiivit kirjastot tarjoavat paremman suorituskyvyn, aikavyöhykkeiden käsittelyn ja tuen edistyneille cron-ominaisuuksille.