ماذا تفعل الأداة
يشرح محلل تعبيرات Cron جدول Cron بلغة واضحة ويعرض الأوقات التالية التي سيعمل فيها. صياغة Cron موجزة لكن الخطأ فيها سهل: هل 0 9 * * 1-5 تعني الساعة التاسعة في أيام العمل، أم كل دقيقة من الساعة التاسعة؟ الصق التعبير هنا قبل نشره وتحقّق بالضبط من وقت تنفيذه.
كما يُفصَّل كل حقل من الحقول الخمسة إلى القيم الدقيقة التي يسمح بها، ما يسهّل اكتشاف الأخطاء في النطاقات والخطوات.
طريقة الاستخدام
- اكتب تعبير Cron في حقل الإدخال، أو انقر مثال.
- اقرأ الوصف وجدول الحقول. تشير الأخطاء إلى الحقل والعمود الخاطئين، مثل ساعة قيمتها 24.
- اختر التوقيت محلي أو UTC للتشغيلات القادمة، وعدد التشغيلات المعروضة.
صياغة Cron
يتكوّن تعبير Cron من خمسة حقول تفصل بينها مسافات:
┌───────────── minute (0–59)
│ ┌─────────── hour (0–23)
│ │ ┌───────── day of month (1–31)
│ │ │ ┌─────── month (1–12 or JAN–DEC)
│ │ │ │ ┌───── day of week (0–7 or SUN–SAT, 0 and 7 are Sunday)
│ │ │ │ │
* * * * *| الرمز | المعنى | مثال |
|---|---|---|
* | كل القيم | * في حقل الساعة = كل ساعة |
, | قائمة | 1,15 = في اليوم 1 و15 |
- | نطاق | MON-FRI = من الاثنين إلى الجمعة |
/ | خطوة | */15 = كل 15 دقيقة |
الاختصارات مقبولة أيضًا: @hourly و@daily (أو @midnight) و@weekly و@monthly و@yearly (أو @annually).
أمثلة
| التعبير | يعمل |
|---|---|
*/5 * * * * | كل 5 دقائق |
0 * * * * | في بداية كل ساعة |
0 9 * * 1-5 | الساعة 09:00 في أيام العمل |
30 2 1 * * | الساعة 02:30 في اليوم الأول من كل شهر |
0 0 * * 0 | عند منتصف الليل كل يوم أحد |
الأسئلة الشائعة
› ما صيغة Cron التي تستخدمها هذه الأداة؟
صيغة Cron القياسية في Unix (Vixie) ذات الحقول الخمسة، المستخدمة في crontab وKubernetes CronJobs وGitHub Actions ومعظم المجدولات. أما الصيغ ذات الحقول الستة التي تتضمن الثواني (Quartz وSpring) فغير مدعومة.
› ماذا يحدث عند تحديد يوم الشهر ويوم الأسبوع معًا؟
يشغّل Cron القياسي المهمة عند تطابق أيّ منهما. فمثلًا 0 0 1,15 * 5 يعمل في اليوم 1 و15 من كل شهر وفي كل يوم جمعة.
› لماذا تختلف أوقات التشغيل على الخادم الخاص بي؟
يستخدم Cron المنطقة الزمنية للجهاز أو الخدمة التي تشغّله. يستخدم GitHub Actions ومعظم المجدولات السحابية توقيت UTC، لذا غيّر المنطقة الزمنية إلى UTC لترى ما ستفعله.
› هل يُسمح بأسماء مثل MON أو JAN؟
نعم. تقبل الأشهر JAN–DEC وتقبل أيام الأسبوع SUN–SAT، بأحرف كبيرة أو صغيرة. ويمكن كتابة الأحد 0 أو 7.