WebGroundwebground.app
Tieto & oppaat · Kehittäjän käsikirja

Cron-lausekkeiden opas & ajastusten tulkki

Opi cron-ajastusten syntaksi yleisten esimerkkien avulla ja liitä mikä tahansa viisikenttäinen lauseke, niin näet, onko se kelvollinen ja milloin se ajetaan seuraavaksi.

Tarkista cron-lauseke

Viisi välilyönnein erotettua kenttää: minuutti, tunti, kuukaudenpäivä, kuukausi, viikonpäivä.

Kelvollinen cron-lauseke

Erittely kenttä kentältä

  • Minuutti

    Sallitut: 0–59

    Arvo
    */15
    Täsmäävät arvot
    • 0
    • 15
    • 30
    • 45
  • Tunti

    Sallitut: 0–23

    Arvo
    9-17
    Täsmäävät arvot
    • 9–17
  • Kuukaudenpäivä

    Sallitut: 1–31

    Arvo
    *
    Täsmäävät arvot
    Kuukauden jokainen päivä
  • Kuukausi

    Sallitut: 1–12

    Arvo
    *
    Täsmäävät arvot
    Joka kuukausi
  • Viikonpäivä

    Sallitut: 0–7

    Arvo
    MON-FRI
    Täsmäävät arvot
    • maanantai–perjantai

Seuraavat ajoajat

Yleiset ajastukset

  • * * * * *
    Milloin ajetaan
    Joka minuutti
    Lyhenne
  • */5 * * * *
    Milloin ajetaan
    5 minuutin välein
    Lyhenne
  • */30 * * * *
    Milloin ajetaan
    30 minuutin välein
    Lyhenne
  • 0 * * * *
    Milloin ajetaan
    Joka tasatunti
    Lyhenne
    @hourly
  • 0 */6 * * *
    Milloin ajetaan
    6 tunnin välein keskiyöstä alkaen
    Lyhenne
  • 0 0 * * *
    Milloin ajetaan
    Joka päivä keskiyöllä
    Lyhenne
    @daily
  • 30 8 * * *
    Milloin ajetaan
    Joka päivä klo 8.30 aamulla
    Lyhenne
  • 0 9 * * 1-5
    Milloin ajetaan
    Maanantaista perjantaihin klo 9.00 aamulla
    Lyhenne
  • 0 0 * * 0
    Milloin ajetaan
    Joka sunnuntai keskiyöllä
    Lyhenne
    @weekly
  • 0 0 1 * *
    Milloin ajetaan
    Keskiyöllä jokaisen kuukauden ensimmäisenä päivänä
    Lyhenne
    @monthly
  • 0 0 1 */3 *
    Milloin ajetaan
    Keskiyöllä tammi-, huhti-, heinä- ja lokakuun ensimmäisenä päivänä
    Lyhenne
  • 0 0 1 1 *
    Milloin ajetaan
    Keskiyöllä 1. tammikuuta joka vuosi
    Lyhenne
    @yearly

Erikoismerkit

  • *
    Merkitys
    Kentän jokainen arvo.
    Esimerkki
    * * * * *
  • ,
    Merkitys
    Luettelo erillisiä arvoja.
    Esimerkki
    0 9,18 * * *
  • -
    Merkitys
    Arvoväli, molemmat päät mukaan lukien.
    Esimerkki
    0 9-17 * * *
  • /
    Merkitys
    Askel: joka n:s arvo välin alusta laskettuna.
    Esimerkki
    */10 * * * *

Näin cron-lauseke rakentuu

Cron-lauseke koostuu viidestä välilyönnein erotetusta kentästä: minuutti, tunti, kuukaudenpäivä, kuukausi ja viikonpäivä. Kukin kenttä kertoo, milloin tehtävä saa käynnistyä, ja tehtävä ajetaan jokaisella minuutilla, jolla kaikki kentät täsmäävät.

Kenttä voi olla yksittäinen numero, kaikkia arvoja tarkoittava tähti, pilkuin erotettu luettelo, yhdysmerkillä merkitty väli tai kauttaviivalla merkitty askel. Kuukaudet ja viikonpäivät voi kirjoittaa myös kolmikirjaimisina englanninkielisinä niminä, kuten JAN tai MON.

Yleisiä sudenkuoppia

Oikealta näyttävä ajastus voi silti käynnistyä odottamattomaan aikaan.

  • Cron käyttää palvelimen aikavyöhykettä, joka voi poiketa omastasi. Yllä näkyvät ajoajat ovat laitteesi aikavyöhykkeen mukaisia.
  • Kun sekä kuukaudenpäivä että viikonpäivä on määritetty, tehtävä ajetaan, kun jompikumpi täsmää.
  • Viikonpäiväkentässä sekä 0 että 7 tarkoittavat sunnuntaita.
  • Askel, kuten */7, alkaa alusta jokaisen uuden tunnin, päivän tai kuukauden alussa, joten välit eivät aina ole tasaiset.

Usein kysytyt kysymykset (FAQ)

Miksi kuusikenttäistä lausekettani ei hyväksytä?+

Linuxin ja macOS:n tavallinen cron käyttää viittä kenttää. Kuusi- tai seitsenkenttäiset lausekkeet ovat peräisin Quartz- ja Spring-ajastimista ja muista vastaavista, jotka lisäävät sekuntikentän ja joskus vuoden ja käyttävät lisämerkkejä, kuten ? ja L.

Mitä lyhenteet, kuten @daily, tarkoittavat?+

Ne ovat yleisten ajastusten lyhyitä nimiä. @hourly, @daily, @weekly, @monthly ja @yearly käynnistyvät kunkin tunnin, päivän, viikon, kuukauden tai vuoden alussa. @reboot ajetaan kerran käynnistyksen yhteydessä, joten sille ei ole näytettäviä ajoaikoja.

Lähetetäänkö kirjoittamani lauseke jonnekin?+

Ei. Lauseke tarkistetaan ja ajoajat lasketaan selaimessasi.

Tutustu muihin WebGround-työkaluihin

Näytä kaikki