النقاط الرئيسية
- 01تشرحات اللغة الإنجليزية العادية تجعل من السهل تأكيد ما سيفعله وظيفة cron بالفعل قبل نشره.
- 02أوقات التشغيل التالية 5 UTC مدرجة بتنسيق ISO-8601 للتحقق من الجدول الزمني الآمن.
- 03يدعم النطاقات (1-5) والقوائم (1,3,5) والخطوات (*/15) التي تتبع قواعد Vixie-cron القياسية.
- 04كل شيء يعمل في متصفحك — لا خلفية، لا حساب، لا طلب شبكة.
لماذا تعابير Cron سهلة للخطأ
صيغة Cron مدمجة بالتصميم، لكن هذا الإحكام يجعل من السهل بشكل مفاجئ جدولة وظيفة في الوقت الخاطئ. نسخة احتياطية منتصف الليل التي تطلق في الظهيرة في UTC، تعبير خطوة ينسى الأوقات المتوقعة، أو قيمة يوم من الأسبوع غير صحيح بمقدار واحد — هذه الأخطاء يصعب اكتشافها حتى لا تعمل الوظيفة بصمت. قراءة 0 */6 * * 1-5 بصوت مرتفع لا تخبرك بالكثير ما لم تعرف ترتيب الحقل عن ظهر قلب.
مولد cron من Handytool يحل هذا بترجمة أي تعبير صحيح إلى جملة يمكنك قراءتها فعلاً، ثم إظهار الأوقات الخمسة التالية التي ستطلق فيها في UTC. امسك الخطأ قبل أن يصل إلى الإنتاج، وليس بعد فشل مهمة مجدولة في صباح الاثنين.
كيفية بناء والتحقق من صحة تعبير Cron
- 01
ابدأ بـ preset أو اكتب الخاص بك
Presets مثل كل دقيقة و في الساعة و يومياً في منتصف الليل و أسبوعياً يوم الاثنين تعطيك نقطة انطلاق صحيحة. التبديل إلى الإدخال اليدوي للجداول المخصصة.
- 02
أدخل حقولك الخمسة
اكتب التعبير بترتيب دقيقة ساعة يوم من الشهر شهر يوم من الأسبوع. يتحقق المولد من حدود كل حقل أثناء الكتابة.
- 03
اقرأ وصف اللغة الإنجليزية العادي
التفسير يحدّث مباشرة. تأكد من أن الجملة تطابق نيتك — على سبيل المثال 'في :00 على كل ساعة 6 من الساعة، الاثنين إلى الجمعة'.
- 04
تحقق من أوقات التشغيل التالية 5
أوقات النار القادمة مدرجة بتنسيق ISO-8601 UTC. استخدمها للتحقق من الحالات الحدودية مثل حدود نهاية الشهر أو تعويضات المناطق الزمنية.
مرجع سريع لصيغة Cron
جميع الحقول الخمسة تتبع هذه القواعد:
- 01علامة النجمة (*) تعني كل قيمة صالحة في الحقل
- 02شرطة مائلة (*/N) تتدرج خلال النطاق بزيادات من N
- 03شرطة (A-B) تطابق كل قيمة من A إلى B شاملة
- 04فاصلة (A,B,C) تطابق قائمة محددة من القيم
- 05نطاقات الحقول: دقيقة 0-59، ساعة 0-23، يوم 1-31، شهر 1-12، weekday 0-6 (الأحد = 0)
لا تثبيت، لا خادم
مولد cron يحلل التعابير ويحسب أوقات next-run بالكامل في متصفحك باستخدام JavaScript. لا شيء يُرسل إلى خادم، لذا لا توجد تسجيل دخول ولا حصة API ولا كمون. حساب next-runs يحاكي مطابقات دقيقة بدقيقة ضد قواعد Vixie-cron القياسية، وهو نفس النهج المستخدم من قبل معظم المخططين الإنتاجيين.
تعابير ذات 6 حقول (مع حقل ثواني رئيسي) وسلاسل خاصة مثل @daily أو @weekly غير مدعومة. معظم الأنظمة الإنتاجية — بما في ذلك cron و Kubernetes و GitHub Actions — استخدم النموذج القياسي ذي 5 حقول، لذا يركز المولد على ذلك.
الأسئلة الشائعة حول مولد تعبير Cron
ما نكهة cron التي يدعمها هذا المولد؟
Vixie-cron ذات 5 حقول القياسية: دقيقة، ساعة، يوم من الشهر، شهر، يوم من الأسبوع. اختصار @daily/@weekly و 6 حقول صيغة الثواني غير مدعومة، لأن معظم المخططين الإنتاجيين يستخدمون النموذج ذي 5 حقول.
لماذا تُعرض أوقات التشغيل التالية بصيغة UTC؟
معظم أنظمة CI/CD والمخططات السحابية تفسر تعابير cron بصيغة UTC. عرض UTC يبقي المعاينة محمولة ويتجنب عروض الوقت المحلي المضللة.
ما الفرق بين */15 و 0,15,30,45 في حقل الدقيقة؟
كليهما يطلق كل 15 دقيقة. */15 يبدأ من 0 و خطوات 15، وهو ما يعادل 0,15,30,45. بالنسبة لحقل الساعة، */6 تعني 0,6,12,18.
هل يمكنني جدولة وظيفة في آخر يوم من الشهر؟
Cron القياسي لا يوجد لديه رمز 'آخر يوم'. يمكنك التقريب مع 28-31 في حقل اليوم، لكن للتعامل مع الأشهر الأقصر من 31 يوماً بنظافة، تحقق من التاريخ داخل نص الوظيفة.
هل هناك طريقة لتشغيل وظيفة في كل يوم عمل في الساعة 9 صباحاً؟
نعم: 0 9 * * 1-5 طلقات في 09:00 UTC الاثنين إلى الجمعة. تحقق منها في مخرجات المولد بلغة إنجليزية عادية وقائمة next-run قبل النشر.