شارح تعبيرات Cron
اقرأ أي تعبير cron بلغة واضحة، حقلًا حقلًا، واعرف بالضبط متى سيعمل في المرة القادمة.
شارح تعبيرات Cron — ماذا يعني سطر crontab فعلًا
الصق تعبير cron واقرأه جملة واضحة، وشاهد كل حقل من الحقول الخمسة على حدة، وراجع مواعيد التشغيل القادمة بمنطقتك الزمنية أو بـ UTC. تكشف الأداة الأخطاء التي تجعل المهمة تعمل في غير وقتها: قيمة خارج النطاق، أو تعبير من ستة حقول منسوخ من Quartz، أو جدول لا يمكن أن يتحقق أبدًا، مثل 31 فبراير.
Cron هو المجدول الذي يقف وراء ملفات crontab في Linux وmacOS، وصيغته مستخدمة أيضًا في Kubernetes CronJobs وGitHub Actions وGitLab CI ومعظم المجدولات السحابية. الصيغة مختصرة وسهلة الفهم الخاطئ؛ ونظرة سريعة هنا تنقذك من مهمة تعمل كل دقيقة بدل مرة واحدة في اليوم.
طريقة الاستخدام
- اكتب تعبير cron أو الصقه، أو اختر واحدًا من جداول شائعة.
- اقرأ الوصف والحقول الخمسة أسفله.
- راجع قائمة مواعيد التشغيل القادمة؛ وبدّل المنطقة الزمنية بين هذا الجهاز وUTC.
- إذا أُحيط حقل بإطار أحمر، فالرسالة فوقه تشرح موضع الخطأ.
الحقول الخمسة
| الحقل | القيم المسموحة | مثال | المعنى |
|---|---|---|---|
| الدقيقة | 0–59 | 30 | عند الدقيقة 30 |
| الساعة | 0–23 | 9-17 | من 09:00 حتى 17:59 |
| يوم الشهر | 1–31 | 1,15 | في اليوم 1 واليوم 15 |
| الشهر | 1–12 أو JAN–DEC | */3 | يناير وأبريل ويوليو وأكتوبر |
| يوم الأسبوع | 0–6 أو SUN–SAT (7 = الأحد) | 1-5 | من الاثنين إلى الجمعة |
المحارف الخاصة
*تعني كل قيم الحقل.,تفصل عناصر قائمة:1,15,30.-تحدد نطاقًا:9-17./تحدد خطوة:*/15تعني كل قيمة خامسة عشرة بدءًا من أدنى قيمة، و5/15كل قيمة خامسة عشرة بدءًا من 5.- الاختصارات تحل محل السطر كله:
@hourlyو@dailyو@weeklyو@monthlyو@yearly.
فخ يوم الشهر ويوم الأسبوع
حين يُقيَّد حقلا اليوم كلاهما، يشغّل cron القياسي المهمة في الأيام التي تطابق أيًّا منهما، لا كليهما معًا. فالتعبير 0 0 1 * 1 يعمل عند منتصف الليل في اليوم الأول من كل شهر، وأيضًا في كل يوم اثنين. وعادة ما يتوقع الناس «أيام الاثنين التي توافق اليوم الأول»، وهذا ما لا يستطيع cron العادي التعبير عنه. وتعرض الأداة ملاحظة كلما حُدِّد الحقلان معًا، وتكشف قائمة مواعيد التشغيل القادمة السلوك الحقيقي بوضوح.
المناطق الزمنية
يستخدم cron المنطقة الزمنية للجهاز أو الخدمة التي تشغّله. والخوادم والمجدولات السحابية مثل GitHub Actions تعمل عادة بتوقيت UTC، لذا قد تنطلق مهمة كُتبت للساعة 09:00 عند 09:00 بتوقيت UTC، وهي ساعة مختلفة في معظم الأماكن، كما تنزاح ساعة كاملة عند بدء التوقيت الصيفي أو انتهائه حيث تعيش. قارن مواعيد التشغيل القادمة بين هذا الجهاز وUTC لترى الفرق قبل النشر.
ما لا تدعمه هذه الأداة
- الثواني: التعبيرات ذات الستة أو السبعة حقول من Quartz وSpring يُنبَّه إليها بدل أن تُقرأ خطأً.
- الامتدادات غير القياسية مثل
LوWو#، التي تضيفها بعض المجدولات. @reboot، الذي يعمل مرة واحدة عند بدء التشغيل وليس له موعد قادم.
أدوات ذات صلة
لتحويل موعد تشغيل إلى طابع زمني Unix أو العكس، استخدم محوّل الطوابع الزمنية. وتفتح صفحات المهام هذه الأداة بجدول شائع: كل 5 دقائق وكل ساعة وكل يوم عند منتصف الليل.