طريقة الاستخدام
- اكتب التعبير في تعبير Cron: خمسة حقول مفصولة بمسافات، أو ماكرو مثل @daily.
- اقرأ ماذا يعني وتأكد من أن الجدول هو الذي قصدته.
- غيّر عدد مواعيد التشغيل المعروضة إن أردت تواريخ أكثر أو أقل.
- قبل أن تعتمد على مواعيد التشغيل التالية، قارن المنطقة الزمنية بالمنطقة التي يستخدمها خادمك.
الحقول الخمسة
تعمل المهمة المجدولة حين يطابق الوقت الحالي الحقول الخمسة كلها. الدقيقة من 0 إلى 59، والساعة من 0 إلى 23، واليوم من الشهر من 1 إلى 31، والشهر من 1 إلى 12، ويوم الأسبوع من 0 إلى 7، حيث 0 و7 كلاهما الأحد. ويمكن أن تحل أسماء محل الأرقام: JAN إلى DEC للشهور، وSUN إلى SAT للأيام، بأي حالة للأحرف.
- النجمة (*) تعني كل قيمة.
- القائمة تفصل القيم بفاصلة، مثل 1,15.
- المدى يربط قيمتين بشرطة، مثل 9-17.
- الخطوة تشغّل كل قيمة n-ية: */15 كل 15 دقيقة، و1-30/5 هي 1 و6 و11 و16 و21 و26.
- الخطوة تحتاج نجمة أو مدى قبل الشرطة المائلة، فلا يصح 5/15.
اليوم من الشهر ويوم الأسبوع معاً
إذا قُيِّد اليوم من الشهر ويوم الأسبوع معاً، يعمل اليوم إذا طابق أحدهما. فمثلاً 0 0 1 * 1 تعمل عند منتصف الليل في أول كل شهر وفي كل اثنين. وإذا بدأ أحد حقلي اليوم بنجمة، وجب أن يطابق الاثنان معاً، فيعمل 0 0 * * 1 يوم الاثنين فقط.
المنطقة الزمنية والتوقيت الصيفي
تُحسب مواعيد التشغيل بالمنطقة الزمنية لجهازك. في اليوم الذي يتقدّم فيه التوقيت تُتخطى الساعة غير الموجودة ولا تعمل أبداً، وفي اليوم الذي يتأخر فيه التوقيت تعمل الساعة المتكررة مرتين، مرة عند كل وقوع، كما يصف crontab(5).
غالباً ما يعمل الخادم بالتوقيت العالمي UTC. والمهمة المضبوطة على 09:00 في منطقتك تعمل في وقت مختلف على الخادم، لذلك تحقق من المنطقة قبل أن تعتمد على وقت ما.
مثال محلول: كل 15 دقيقة من 9 إلى 17، من الاثنين إلى الجمعة
التعبير */15 9-17 * * MON-FRI يعني: كل 15 دقيقة بين الساعة 09:00 و17:59، من الاثنين إلى الجمعة. يعمل عند 09:00 و09:15 و09:30 و09:45، وهكذا حتى 17:45: 36 مرة في اليوم، أي 180 مرة في أسبوع من الاثنين إلى الجمعة.
تبدأ قائمة مواعيد التشغيل التالية بأول موعد منها بعد الوقت الحالي.
الأسئلة الشائعة
ما هو تعبير cron؟
هو نص قصير يصف متى تعمل مهمة مجدولة. يقرؤه المجدول cron على لينكس ويونكس، وتستخدم خدمات كثيرة الصيغة نفسها. والحقول الخمسة هي الدقيقة والساعة واليوم من الشهر والشهر ويوم الأسبوع.
لماذا تختلف مواعيد التشغيل هنا عما يفعله خادمي؟
تستخدم هذه الصفحة المنطقة الزمنية لجهازك، والخوادم غالباً تستخدم التوقيت العالمي UTC. وبعض الخدمات لها إعداد منطقة زمنية خاص بها، فتحقق منه إلى جانب التعبير.
هل تدعم الأداة الثواني؟
لا. يتكوّن cron القياسي من خمسة حقول، وأصغر خطوة فيه دقيقة واحدة. وبعض المجدولات تضيف حقلاً سادساً للثواني، وهذه الصفحة لا تقرؤه.
ماذا يحدث مع 31 فبراير؟
هذا اليوم لا يأتي أبداً، فالتعبير الذي يطلبه لا يملك مواعيد تشغيل. وتقول الصفحة ذلك ولا تعرض أي موعد.
لماذا لا يعمل @reboot هنا؟
يعمل @reboot مرة واحدة عند تشغيل الجهاز، فليس له موعد تشغيل تالٍ لعرضه. وتقبل الصفحة الماكرو التي تتكرر على جدول زمني فقط.
هل تُرسل تعبيراتي إلى خادم؟
لا. تُجرى الحسابات داخل متصفحك باستخدام وقت جهازك.
المصادر
آخر مراجعة للأرقام والنص: الثلاثاء، 30 جمادى الأولى 1448 بعد الهجرة.