الأحرف الخاصة في Quartz: شرح L وW و#

لماذا تُعدّ الأحرف الخاصة في Quartz مهمة

تبدأ معظم أخطاء cron قبل النشر، عندما يتباعد القصد من الجدولة عن الصياغة الفعلية. يغطي cron القياسي ذو الخمسة حقول: الدقائق والساعات ويوم الشهر والشهر ويوم الأسبوع. يوسّع Quartz هذا بإضافة حقل الثواني وحقل السنة وثلاثة أحرف خاصة — L وW و# — تتيح دقة في الجدولة لا يستطيع cron القياسي تحقيقها.

تتصرف هذه الأحرف بشكل مختلف بحسب الحقل الذي تظهر فيه، وسوء الفهم البسيط يتراكم ليُنتج جداول تُنفَّذ في اليوم الخاطئ أو تتخطى التشغيل بالكامل. يشرح هذا المقال كل حرف مع أمثلة عملية وفحوصات للتحقق وإجراءات واضحة يمكنك اتخاذها في مولّد Quartz في Cronwise.

حرف L: آخر يوم وآخر يوم من أيام الأسبوع

يرمز L إلى "الأخير" (Last) وهو صالح في حقلين: يوم الشهر ويوم الأسبوع. يتغير معناه بحسب مكان وضعه.

L في حقل يوم الشهر

عند استخدامه وحده، يعني L آخر يوم في الشهر. التعبير 0 0 18 L * ? يُنفَّذ في الساعة 6:00 مساءً في آخر يوم من كل شهر — سواء كان اليوم 28 أو 29 أو 30 أو 31. لن تحتاج أبداً لترميز أطوال الأشهر يدوياً.

يمكنك دمج L مع إزاحة سالبة. L-3 يعني ثلاثة أيام قبل آخر يوم. في شهر من 31 يوماً يُحلّ إلى اليوم 28؛ وفي فبراير من سنة غير كبيسة يُحلّ إلى اليوم 25. هذا مفيد لنوافذ قطع الفواتير.

L في حقل يوم الأسبوع

في حقل يوم الأسبوع، تقرن L برقم يوم الأسبوع: 6L يعني آخر جمعة في الشهر. التعبير 0 0 9 ? * 6L يُنفَّذ في الساعة 9:00 صباحاً في آخر جمعة من كل شهر — مفيد لمعالجة الرواتب أو تقارير نهاية الشهر التي يجب أن تقع في يوم محدد من الأسبوع.

حرف W: أقرب يوم عمل

W صالح فقط في حقل يوم الشهر. يختار أقرب يوم عمل (من الاثنين إلى الجمعة) للتاريخ المحدد. اكتب 15W لتعني "أقرب يوم عمل للخامس عشر."

كيف يُحلّ W

إذا صادف الخامس عشر يوم سبت، ينتقل الجدول إلى الجمعة الرابع عشر. وإذا صادف يوم أحد، ينتقل إلى الاثنين السادس عشر. لا يتجاوز الحل حدود الشهر أبداً: إذا كان اليوم الأول سبتاً، يُحلّ 1W إلى الاثنين الثالث، وليس إلى الجمعة السابقة.

دمج L وW

يسمح Quartz بالدمج LW، أي "آخر يوم عمل في الشهر." هذا مثالي لعمليات الإغلاق المالي في نهاية الشهر التي يجب تنفيذها في يوم عمل. إذا كان آخر يوم هو السبت، يُحلّ LW إلى الجمعة. لاحظ أن W لا يمكن دمجه مع قائمة أو نطاق — تعبيرات مثل 1W,15W غير صالحة.

حرف #: يوم الأسبوع رقم N في الشهر

# صالح فقط في حقل يوم الأسبوع ويحدد التكرار رقم N ليوم أسبوع معين ضمن الشهر. الصياغة هي day#N، حيث day هو رقم يوم الأسبوع (1–7، من الأحد إلى السبت) وN هو رقم التكرار (1–5).

أمثلة عملية

0 0 10 ? * 2#1 يُنفَّذ في الساعة 10:00 صباحاً في أول اثنين من كل شهر. 0 0 14 ? * 6#3 يُنفَّذ في الساعة 2:00 مساءً في ثالث جمعة. تحل هذه الأنماط محل الحلول البديلة الهشة التي تعتمد على نطاقات يوم الشهر والمنطق الشرطي.

عندما يتجاوز N التكرارات الفعلية

إذا حددت 2#5 (الاثنين الخامس)، فلن يُنفَّذ الجدول في الأشهر التي تحتوي على أربعة أيام اثنين فقط. يتعامل Quartz مع هذا على أنه عدم تطابق وليس خطأ — وهو تخطٍّ صامت يجعل مراقبة عدد التشغيلات أمراً ضرورياً.

لا يمكن أن يظهر حرف # في حقل يوم الشهر ولا يمكن دمجه مع القوائم أو النطاقات أو الزيادات. يقبل كل حقل يوم أسبوع تحديد # واحد على الأكثر.

تجميع كل شيء معاً

تمنحك أحرف L وW و# في Quartz قوة جدولة لا يستطيع cron القياسي مطابقتها. L يتكيف مع أطوال الأشهر المتغيرة، وW يحاذي التنفيذ مع أيام العمل، و# يثبّت التشغيلات على تكرارات أيام أسبوع محددة. عند استخدامها بشكل صحيح، تُزيل الحلول البديلة الهشة وتجعل قصد الجدولة واضحاً في التعبير نفسه.

قواعد القرار الأساسية بسيطة. استخدم L لمنطق نهاية الشهر. استخدم W عندما تحتاج أقرب يوم عمل. استخدم # ليوم الأسبوع رقم N من الشهر. ضع دائماً ? في حقل اليوم الذي لا تستخدمه. وتحقق دائماً بمعاينة التشغيل التالي قبل النشر.

هل أنت مستعد لبناء أو التحقق من جدول Quartz الخاص بك؟ افتح مولّد Quartz في Cronwise لبناء التعبيرات بصرياً ورؤية شروحات بلغة واضحة ومعاينة أوقات التنفيذ في المنطقة الزمنية المستهدفة. لمزيد من أدلة جدولة cron والشروحات المعمّقة، تصفح جميع مقالات cron على Cronwise.