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.

پارسر عبارت کرون

شامل ثانیه‌ها:خاموش

تاریخ‌های زمان‌بندی‌شده بعدی:

قالب خروجی:

عبارت کرون برای تجزیه

قالب: دقیقه (0-59) ساعت (0-23) روز (1-31) ماه (1-12) روزِ هفته (0-6، 0=یکشنبه)

نمونه‌ها

جزئیات فنی

مفسر عبارت Cron چگونه کار می‌کند

این ابزار چه کاری انجام می‌دهد

مفسر عبارت cron، عبارت‌های cron را تفسیر می‌کند و آن‌ها را به توضیحات قابل‌فهم برای انسان و زمان‌های اجرای زمان‌بندی‌شده ترجمه می‌کند. این cron parser هم به‌عنوان مترجم عبارت cron، هم مولد عبارت cron و هم مولد زمان‌بندی cron عمل می‌کند و به توسعه‌دهندگان کمک می‌کند بفهمند cron jobها چه زمانی اجرا خواهند شد. وقتی نیاز دارید عبارت‌های cron را parse کنید یا cron را به قالب قابل‌خواندن برای انسان تبدیل کنید، این ابزار نتایج فوری ارائه می‌دهد. این مفسر از عبارت‌های cron استاندارد 5 فیلدی (دقیقه، ساعت، روزِ ماه، ماه، روزِ هفته) و عبارت‌های 6 فیلدی که شامل ثانیه‌ها هستند پشتیبانی می‌کند. بر اساس زمان فعلی، اجرای‌های بعدی زمان‌بندی‌شده را محاسبه می‌کند و آن‌ها را در قالبی خوانا نمایش می‌دهد. اعتبارسنج cron نحو را بررسی می‌کند و توضیحات دقیقی از زمان اجرای کارها ارائه می‌دهد. این مفسر crontab به توسعه‌دهندگان کمک می‌کند پیش از استقرار در سیستم‌های تولیدی، عبارت‌های cron را راستی‌آزمایی کنند.

موارد استفادهٔ رایج برای توسعه‌دهندگان

توسعه‌دهندگان هنگام پیکربندی وظایف زمان‌بندی‌شده، عیب‌یابی مشکلات cron job یا درک عبارت‌های cron موجود در کدبیس‌ها از cron parserها استفاده می‌کنند. یک مفسر عبارت cron و مولد عبارت cron کمک می‌کند پیش از استقرار در تولید، درست بودن عبارت‌ها تأیید شود. بسیاری از توسعه‌دهندگان از cron parserها برای ترجمه‌ی عبارت‌های پیچیده به توضیحات قابل‌فهم برای انسان استفاده می‌کنند تا درک زمان اجرای کارها آسان‌تر شود. مفسر crontab هنگام کار با مدیریت سیستم، پایپ‌لاین‌های CI/CD، پشتیبان‌گیری‌های زمان‌بندی‌شده یا وظایف خودکار ارزشمند است. توسعه‌دهندگان از آن برای اعتبارسنجی عبارت‌های cron، محاسبه‌ی زمان اجرای بعدی cron یا تولید عبارت‌های cron برای نیازهای زمان‌بندی مشخص استفاده می‌کنند. این ابزار هنگام عیب‌یابی اینکه چرا یک cron job مطابق انتظار اجرا نشده یا هنگام مستندسازی وظایف زمان‌بندی‌شده کمک می‌کند.

قالب‌ها، نوع‌ها یا گونه‌های داده

عبارت‌های Cron از قالبی با فیلدهای جداشده با فاصله استفاده می‌کنند که 5 یا 6 فیلدِ نمایانگر واحدهای زمانی دارد. قالب استاندارد 5 فیلدی عبارت است از: دقیقه (0-59)، ساعت (0-23)، روزِ ماه (1-31)، ماه (1-12) و روزِ هفته (0-6، که 0 یکشنبه است). قالب 6 فیلدی ثانیه‌ها (0-59) را در ابتدای عبارت اضافه می‌کند. هر فیلد از wildcardها (*)، بازه‌ها (1-5)، فهرست‌ها (1,3,5) و مقادیر گام (*/5) پشتیبانی می‌کند. برخی سیستم‌ها از 5 فیلد استفاده می‌کنند، برخی 6 فیلد (با ثانیه‌ها)، و cron به سبک Quartz با cron استاندارد یونیکس متفاوت است. این مفسر از معناشناسی استاندارد cron در یونیکس پیروی می‌کند؛ اگر عبارت شما جای دیگری کار می‌کند اما اینجا نه، ممکن است تفاوت لهجه (dialect) باشد.

نمونه‌های رایج عبارت cron:

0 9 * * 1-5 — ساعت 9:00 صبح در روزهای کاری
*/15 * * * * — هر 15 دقیقه
0 0 * * 0— هر یکشنبه در نیمه‌شب
0 0 1 * *— روز اول هر ماه

مفسر این گونه‌گونی‌ها را مدیریت می‌کند و زمان‌های اجرای بعدی را مطابق آن محاسبه می‌کند.

دام‌های رایج و حالت‌های لبه‌ای

یکی از اشتباهات رایج، اشتباه گرفتن شماره‌گذاری روزهای هفته است: این مفسر از 0 تا 6 استفاده می‌کند (یکشنبه تا شنبه، که 0 یکشنبه است)، در حالی که برخی سیستم‌ها از 1 تا 7 استفاده می‌کنند (دوشنبه تا یکشنبه). مسئله‌ی دیگر مدیریت منطقه‌ی زمانی است: عبارت‌های cron معمولاً در منطقه‌ی زمانی سرور ارزیابی می‌شوند که ممکن است با منطقه‌ی زمانی محلی شما متفاوت باشد. روزِ ماه و روزِ هفته معناشناسی OR دارند: اگر هر دو مشخص شوند (نه *)، کار زمانی اجرا می‌شود که یکی از شرط‌ها درست باشد، که می‌تواند گیج‌کننده باشد. برای مثال، عبارت 0 9 15 * 1 ساعت 9 صبح در روز 15 هر ماه OR هر دوشنبه اجرا می‌شود، نه فقط زمانی که هر دو شرط برقرار باشند. مرزهای ماه می‌توانند مشکل‌ساز شوند: یک cron job که برای روز 31 برنامه‌ریزی شده باشد در ماه‌هایی که روزهای کمتری دارند اجرا نمی‌شود. مفسر این حالت‌های مرزی را مدیریت می‌کند، اما توسعه‌دهندگان باید از تفاوت‌های منطقه‌ی زمانی و شرایط مرزی تاریخ آگاه باشند. سال‌های کبیسه و گذارهای ساعت تابستانی نیز می‌توانند بر زمان‌های اجرای زمان‌بندی‌شده اثر بگذارند. هنگام استفاده از مقادیر گام همراه با بازه‌ها، مطمئن شوید گام به‌طور یکنواخت به بازه تقسیم می‌شود تا از رفتارهای غیرمنتظره جلوگیری شود.

چه زمانی از این ابزار استفاده کنیم در برابر کُد

از این cron parser برای اعتبارسنجی سریع عبارت‌ها، درک cron jobهای موجود یا تولید توضیحات قابل‌فهم برای انسان استفاده کنید. این ابزار برای عیب‌یابی مشکلات cron job، مستندسازی وظایف زمان‌بندی‌شده یا یادگیری نحو عبارت cron ایده‌آل است. برای کد تولیدی، از کتابخانه‌های پارس cron که در برنامه‌ی شما یکپارچه می‌شوند استفاده کنید تا بتوانند عبارت‌ها را اعتبارسنجی کنند، زمان‌های اجرای بعدی را محاسبه کنند و با سیستم‌های زمان‌بندی کارها یکپارچه شوند. کتابخانه‌های cron مدیریت خطای بهتر، پشتیبانی از منطقه‌ی زمانی و یکپارچه‌سازی با زمان‌بندهای وظیفه را فراهم می‌کنند. ابزارهای مرورگر در پارس موردی (ad-hoc) و یادگیری عالی هستند، در حالی که راهکارهای مبتنی بر کد اتوماسیون، اعتبارسنجی در پایپ‌لاین‌های CI/CD و یکپارچه‌سازی با چارچوب‌های زمان‌بندی کارها را فراهم می‌کنند. برای سیستم‌های زمان‌بندی سازمانی، کتابخانه‌های بومی عملکرد بهتر، مدیریت منطقه‌ی زمانی و پشتیبانی از قابلیت‌های پیشرفته‌ی cron را ارائه می‌دهند.