CDRN

Ikkalkula l-eżekuzzjonijiet li jmiss ta' espressjoni cron

  • Dashboard
  • Dokumentazzjoni
  • API
janalizza u juri d-dati li jmiss ta' eżekuzzjoni tal-konfigurazzjoni cron

X'inhi espressjoni cron?

Aespressjoni cronhija string qasira li tiddeskrivi rikorrenza maż-żmien. Il- format wiret minn Unix fih ħames oqsma separati bi spazji: minuta, siegħa, jum tax-xahar, xahar u jum tal-ġimgħa. Din is-sintassi twieldet bid-daemon cron minn Brian Kernighan fis-snin sebgħin, imbagħad ġeneralizzat mill-Vixie cron (1987) appoġġjat mid-distribuzzjonijiet moderni kollha tal-Linux u macOS. Illum, l-istess sintassi hija misjuba fil-maġġoranza tal-cloud schedulers (AWS EventBridge, GCP Cloud Scheduler, Azure Logic Apps) u CI/CD (Azzjonijiet GitHub, GitLab CI, Jenkins). 

┌──── minuta (0-59)
│ ┌── siegħa (0-23)
│ │ ┌── jum tax-xahar (1-31)
│ │ │ ┌── xhur (1-12 jew JAN-DEC)
│ │ │ │ ┌── jum tal-ġimgħa (0-7 jew SUN-SAT, 0 u 7 = il-Ħadd)
│ │ │ │ │
* * * * *

Aespressjoni cronffurmata tajjeb għalhekk tiddefinixxiskeda cronpreċiża: kull qasam jista 'jkun valur fiss, firxa, lista, pass jew asterisk li jaqbel ma' kollox. Il-kumpattezza tal-espressjoni crontabhija s-saħħa tagħha, iżda hija wkoll dak li jagħmilha decoder cronessenzjali biex jivvalidaw viżwalment l-intenzjoni. Dak hu l-punt kollu ta' dankonvertitur cron: tipproduċi spjegazzjoni cron li tinqara, flimkien mal-lista ta eżekuzzjonijiet li jmiss.

Anatomija ta' espressjoni cron

Il-ħames oqsma jaqsmu grammatika komuni. Hawn huma l-limiti aċċettati minn kull kolonna ta 'a Espressjoni standardcrontab:

  • Minuta: 0-59.
  • Ħin: 0-23, format ta' 24 siegħa.
  • Jum tax-xahar: 1-31.
  • Xahar: 1-12 jew l-abbrevjazzjonijiet testwali JAN, FEB, MAR, APR, MEJJU, ĠUN, LUL, AUG, SET, OCT, NOV, DEC.
  • Jum tal-ġimgħa: 0-7 fejn 0 u 7 it-tnejn jirrappreżentaw il-Ħadd, jew l-abbrevjazzjonijiet SUN, MON, TUE, WED, THU, FRI, SAT.

Karattri speċjali kondiviżi mill-ħames oqsma:

  • *: kwalunkwe valur, jaqbel mal-valuri kollha permessi fil-qasam.
  • ,: lista diskreta, pereżempju 1,15,30 fil-qasam tal-minuta.
  • -: firxa inklużiva, pereżempju 9-17 għall-ħinijiet tal-uffiċċju.
  • /: pass, pereżempju */15 = kull 15-il unità, jew 0-30/5 = kull 5 minuti bejn 0 u 30.

Estensjonijiet tal-kwarz (Java, AWS EventBridge, Spring): il-grammatika tiżdied għal 6 jew 7 oqsma b'kolonna sekondi fir-ras (0-59) u xi kultant kolonna Wara sena (1970-2099). Il-kwarz jintroduċi wkoll ? (mhux speċifiku valur, biex tiddiżakkoppja l-jum tax-xahar u l-jum tal-ġimgħa), L (l-aħħar: l-aħħar jum tax-xahar, jew nhar il-Ġimgħa li għadda bi 5L), W (l-eqreb jum tan-negozju) u # (L-N-jum tal-ġimgħa tax-xahar, pereżempju 2#3 għat-3 Tnejn). Espressjoni Il-kwarz ġeneralment mhuwiex kompatibbli ma 'crontab UNIX, u viċi versa: dan huwa l-prinċipali sors ta 'żball meta tikkopjaespressjoni cronminn pjattaforma għal oħra. 

# UNIX / Vixie cron (5 oqsma)
0 9 * * 1-5

# Kwarz (6 oqsma b'sekondi)
0 0 9 ? * LNEJN-ĠIM

# Kwarz (7 oqsma mas-sena)
0 0 9 ? * MON-ĠIM 2026

Għaliex jiddekowdja espressjoni cron?

Il-qari ta' 0 0 * * * huwa mgħaġġel. Qari */7 2-5 1.15 * 1-5 huwa ħafna inqas. Meta espressjoni hija lil hinn mill-trivjali, ir-riskju ta 'żball ta' interpretazzjoni jiżdied u l-decode cron isir stadju ta’ reviżjoni fih innifsu.

  • Iddibaggja produzzjoni: tifhem għaliex kompitu ġie attivat fit-03:17 u mhux fi 03:00, jew identifika koinċidenza bejn żewġ xogħlijiet.
  • Reviżjoni tal-kodiċi: ivvalida li scheduler imbuttat bħala talba ta' ġibda jagħmel dak li jagħmel isostni l-awtur, mingħajr ma jkollu għalfejn jimmemorizza s-semantika ta’ kull simbolu.
  • Verifika tal-Iskedatur: Irrevedi l-impjiegi cron tal-Linux fi /etc/crontab u /etc/cron.d/, Jenkins iqanqal, spec.schedule ta 'Kubernetes CronJob, ir-regoli ImpjiegiAWS EventBridgeuGCP Cloud Scheduler.
  • Migrazzjoni tal-wirt: ibda mill-ġdid /etc/crontab storiku mingħajr dokumentazzjoni u tibni mill-ġdid il-mappa tal-ħidma qabel bidla fl-infrastruttura.
  • Onboarding: ħalli żviluppatur ġdid jaqra mill-ġdid crontab mingħajr ma jkollhom għalfejn jitgħallmu l-karattri speċjali kollha matul il-lejl.

Kif tuża cron decoder

Il-proċedura li trid issegwi biex tiddikowdja espressjonicrontabbl-għodda:

  1. Pasta l-espressjoni cron tiegħek fil-qasam tad-dħul (5 oqsma separati minn spazji).
  2. Indika n-numru ta' eżekuzzjonijiet li jmiss biex tikkalkula.
  3. Ikklikkja fuq konverti biex tniedi d-dekowd tal-cron: l-għodda tirritorna sentenza umana li tispjega l-iskattar, flimkien mal-lista datata tal-eżekuzzjonijiet li jmiss.
  4. Iċċekkja viżwalment li d-dati jikkorrispondu mal-intenzjoni tiegħek (ħin, jum, frekwenza).
  5. Ikkopja l-output permezz tal-buttuna tal-kopja biex waħħalha f'biljett, PR jew dokumentazzjoni tekniku.

L-għodda ma tipprovdix biss parsing sintattiku: tipprovdispjegazzjoni cronfil-lingwa naturali, li jagħmilha kemmdecoder cronu a validatur tal-iskeda.

Eżempji klassiċi ta 'espressjoni cron

Il-mudelli hawn taħt ikopru ħafna mill-skedi cron li jiltaqgħu magħhom fil-produzzjoni. Huma huma kollha validi fuq Linux crontab, Kubernetes CronJob, GitHub Actions u l-maġġoranza tal- pjanifikaturi tal-applikazzjoni.

Biextesegwixxi kompitu cronfuq server Linux, editja l-crontab tal-utent mill-qoxra: 

# editja l-crontab tal-utent attwali
$ crontab -e

# elenka l-kompiti eżistenti
$ crontab -l

# eżempju ta 'linja miżjuda: backup ta' kuljum fit-3am
0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1

Eżempju ta' produzzjoni konvertitur cron għal */5 * * * *: 

2026-05-05 00:00:00
2026-05-05 00:05:00
2026-05-05 00:10:00
2026-05-05 00:15:00
2026-05-05 00:20:00
...

Mistoqsijiet frekwenti dwar id-decoder cron

X'inhi d-differenza bejn UNIX cron u Quartz?

UNIX/Vixie cron juża 5 oqsma (minuta sal-ġurnata tal-ġimgħa), mingħajr preċiżjoni għat-tieni, u m'għandux kunċett indiġenu ta’ “l-aħħar jum tax-xahar”. Kwarz (Java, Spring, AWS EventBridge) iżid kolonna sekondi fin-naħa ta’ fuq, xi kultant kolonna ta’ sena fin-naħa t’isfel, u diversi simboli (?, L, W, #) nieqes mill-crontab tal-Linux. A espressjoni cronQurz 6-field huwa għalhekk mhux direttament portabbli għal /etc/crontab, u viċi versa. Tagħnadecoder cronjimmira l-format 5 oqsma, li jkopri l-maġġoranza tal-pjanifikaturi.

Kif tmexxi xogħol cron kull 5 minuti?

Bil-pass / fuq il-field tal-minuta: 

*/5 * * * * /usr/local/bin/check-health.sh

Din l-espressjoni crontabtqajjem l-iskrittura fil-minuti 0, 5, 10, 15... ta’ kull siegħa, kuljum. Biex tillimita għas-sigħat tax-xogħol mit-Tnejn sal-Ġimgħa, żid ir-restrizzjonijiet fil-kampijiet tal-ħin u tal-ġurnata tal-ġimgħa: */5 9-17 * * 1-5.

Xi jfisser l-asterisk (*) f'espressjoni cron?

L-asterisk ifisser kwalunkwe valur: jaqbel mal-valuri kollha awtorizzati tal-qasam. Fil 0 0 * * *, it-tliet stilel ifissru “kull jum tax-xahar, kull xahar, kull jum tal-ġimgħa. Flimkien mal-ewwel żewġ oqsma stabbiliti għal 0, aħna gets "kuljum f'nofsillejl". L-istilla tista' wkoll tiġi kkombinata ma' pass: */15 pulzieri minuta = kull 15-il minuta.

Crontab għandu żona tal-ħin?

Defaults għaż-żona tal-ħin tas-server. Fuq crontab Linux, hija s-sistema TZ (spiss UTC fuq VPS u kontenituri). Azzjonijiet GitHub jġiegħel UTC. Kubernetes CronJob juża ż-żona tal-ħin tal-kontrollur, konfigurabbli permezz ta' spec.timeZone mill-1.27. AWS EventBridge jevalwa espressjonijiet minn UTC. Applikazzjoni Schedulers (Symfony Scheduler, Quartz, Airflow) spiss jippermettu li inti tissettja a żona tal-ħin iddedikata għal kull kompitu. Jekk għandek dubju, iċċekkja data fuq is-server fil-mira u qabbel mal-output tal-konvertitur cron.

Cron job vs fil-kmand: liema waħda tagħżel?

cron jintuża biex tesegwixxi kompitu rikorrenti skont skeda. Jintuża fi biex tesegwixxi kmand darba bissf'ħin partikolari. Għal backup ta' kuljum, rotazzjoni log jew sejħa API regolari, uża cron. Biex tiddiferixxi operazzjoni waħda (“erġa ibda dan l-iskjerament fl-10 p.m. illejla”), uża fi: 

$ echo "/usr/local/bin/deploy.sh" | fit-22:00
Kif tittestja espressjoni cron mingħajr ma tiskattaha?

Dan huwa preċiżament ir-rwol ta ' dankonvertitur cron: tikkalkula l-N li jmiss eżekuzzjonijiet mill-ħin attwali, mingħajr ma jibda xi xogħol. Inti immedjatament tara jekk tiegħek espressjoni crontab tispara fit-03:00 kif mistenni jew 03:17 b'inċident. Biex tmur lil hinn ferm qabel ma tinstalla l-kompitu, tista 'wkoll tittestja l-iskript waħdu (bash -x script.sh) u iċċekkja s-sintassi ta' fajl crontab b'file crontab -T fuq id-distribuzzjonijiet li jappoġġjawh.

X'jiġri jekk il-ġurnata tax-xahar u l-ġurnata tal-ġimgħa huma t-tnejn stabbiliti?

Fuq Vixie cron (Linux), ir-regola hija loġikaJEW: ix-xogħol jispara jekkwieħed jew l- iera taż-żewġ kampijiet taqbel. Dan huwa kontrointuwittiv u sors ta 'bugs. Il-kwarz juża a U, għalhekk l-introduzzjoni tas-simbolu ? biex tindika espliċitament “le restrizzjoni.” Bħala regola ġenerali, iffissa biss wieħed miż-żewġ oqsma.

Eżempju ta' talba

curl -X POST https://cdrn.fr/api/v1/tools/cron-converter/execute \
  -H "Content-Type: application/json" \
  -d '{"cron":"...","number_next_date":1}'

Skema ta' input

Espressjoni Qari tal-bniedem
* * * * * Kull minuta
0 * * * * Kull siegħa qawwija
0 0 * * * Kuljum f'nofsillejl
0 0 * * 0 Kull nhar ta' Ħadd f'nofsillejl
*/15 * * * * Kull 15-il minuta
0 9 * * 1-5 9:00 a.m. Mit-Tnejn sal-Ġimgħa
0 0 1 * * L-1 ta' kull xahar f'nofsillejl
0 0.12 * * * F'nofsillejl u nofsinhar kuljum
*/5 9-17 * * 1-5 Kull 5 minuti matul il-ħinijiet tax-xogħol
30 2 1.15 * * L-1 u l-15 tax-xahar fis-2:30 a.m.
Kamp Tip Meħtieġ Default
cron string ✓ –
number_next_date integer ✓ –

Endpoints

  • GET https://cdrn.fr/api/v1/tools - telenka l-għodod kollha disponibbli
  • GET https://cdrn.fr/api/v1/tools/cron-converter - tikseb l-iskema ta' din l-għodda
  • POST https://cdrn.fr/api/v1/tools/cron-converter/execute - teżegwixxi din l-għodda b'payload JSON