What is a cron expression?

A cron expression is a string of 5 (or 6) fields that defines a recurring schedule for automated tasks. The fields represent minute, hour, day-of-month, month, and day-of-week. For example, '0 9 * * 1-5' means 'at 09:00 on every weekday'. Cron is used in Linux crontab, GitHub Actions, AWS EventBridge, Kubernetes CronJobs, and most task schedulers.

What does each field in a cron expression mean?

A standard 5-field cron expression is: [minute] [hour] [day-of-month] [month] [day-of-week]. Each field accepts numbers, ranges (1-5), step values (*/15), lists (1,3,5), or * for 'any'. For example: '*/15 * * * *' = every 15 minutes; '0 0 * * 0' = midnight every Sunday; '30 8 1 * *' = 8:30 AM on the 1st of every month.

What is the difference between a cron expression and a cron schedule?

The terms are often used interchangeably. A 'cron expression' usually refers to the raw string (e.g., '0 9 * * 1-5'), while a 'cron schedule' may refer to the complete definition including the command and environment. Some systems like AWS and Spring use a 6-field or 7-field variant that adds a seconds field or a year field.

How do I write a cron expression to run every 5 minutes?

Use '*/5 * * * *' to run every 5 minutes. The */5 step notation divides the minute field (0-59) into intervals of 5. Similarly: '*/10 * * * *' = every 10 minutes, '0 * * * *' = every hour on the hour, '0 0 * * *' = once per day at midnight, '0 9-17 * * 1-5' = every hour during business hours on weekdays.

محلل تعبيرات Cron

تضمين الثواني:إيقاف

مواعيد الجدولة القادمة:

تنسيق الإخراج:

تعبير Cron المراد تحليله

التنسيق: دقيقة (0-59) ساعة (0-23) يوم (1-31) شهر (1-12) يوم الأسبوع (0-6، 0=الأحد)

أمثلة

التفاصيل التقنية

كيف يعمل محلّل تعبيرات Cron

ما الذي تفعله الأداة

يفسّر محلّل تعبيرات cron تعبيرات cron ويحوّلها إلى أوصاف قابلة للقراءة البشرية وأوقات تنفيذ مجدولة. يعمل محلّل cron هذا كمترجم لتعبيرات cron، ومولّد لتعبيرات cron، ومولّد لجدول cron، مما يساعد المطورين على فهم متى ستُنفَّذ وظائف cron. عندما تحتاج إلى تحليل تعبيرات cron أو تحويل cron إلى صيغة قابلة للقراءة البشرية، توفر هذه الأداة نتائج فورية. يدعم المحلّل تعبيرات cron القياسية ذات 5 حقول (الدقيقة، الساعة، يوم الشهر، الشهر، يوم الأسبوع) وتعبيرات ذات 6 حقول تتضمن الثواني. يحسب مرات التشغيل التالية بناءً على الوقت الحالي ويعرضها بصيغة مقروءة. يتحقق مدقق cron من الصياغة ويقدم أوصافًا تفصيلية لمواعيد تنفيذ الوظائف. يساعد محلّل crontab هذا المطورين على التحقق من تعبيرات cron قبل نشرها على أنظمة الإنتاج.

حالات استخدام شائعة للمطورين

يستخدم المطورون محلّلات cron عند تهيئة المهام المجدولة، أو تصحيح مشكلات وظائف cron، أو فهم تعبيرات cron الموجودة في قواعد الشيفرة. يساعد محلّل تعبيرات cron ومولّد تعبيرات cron على التحقق من صحة التعبيرات قبل نشرها على أنظمة الإنتاج. يستخدم كثير من المطورين محلّلات cron لترجمة التعبيرات المعقدة إلى أوصاف قابلة للقراءة البشرية، مما يسهل فهم متى ستعمل الوظائف. يُعد محلّل crontab ذا قيمة عند العمل في إدارة الأنظمة، وخطوط CI/CD، والنسخ الاحتياطي المجدول، أو المهام المؤتمتة. يستخدمه المطورون للتحقق من تعبيرات cron، أو حساب أوقات التشغيل التالية لـ cron، أو توليد تعبيرات cron لمتطلبات جدولة محددة. تساعد الأداة عند تصحيح سبب عدم تشغيل وظيفة cron كما هو متوقع أو عند توثيق المهام المجدولة.

تنسيقات البيانات أو أنواعها أو متغيراتها

تستخدم تعبيرات Cron تنسيقًا مفصولًا بمسافات يتكون من 5 أو 6 حقول تمثل وحدات زمنية. تنسيق 5 حقول القياسي هو: الدقيقة (0-59)، الساعة (0-23)، يوم الشهر (1-31)، الشهر (1-12)، ويوم الأسبوع (0-6، حيث 0 هو الأحد). يضيف تنسيق 6 حقول الثواني (0-59) في البداية. يدعم كل حقل البدائل العامة (*)، والنطاقات (1-5)، والقوائم (1,3,5)، وقيم الخطوة (*/5). تستخدم بعض الأنظمة 5 حقول، وبعضها 6 (مع الثواني)، كما يختلف cron بنمط Quartz عن cron القياسي في Unix. يتبع هذا المحلّل دلالات cron القياسية في Unix؛ إذا كان تعبيرك يعمل في مكان آخر ولكن ليس هنا، فقد يكون السبب اختلاف اللهجة.

أمثلة شائعة لتعبيرات cron:

0 9 * * 1-5 — عند 9:00 صباحًا في أيام الأسبوع
*/15 * * * * — كل 15 دقيقة
0 0 * * 0— كل يوم أحد عند منتصف الليل
0 0 1 * *— اليوم الأول من كل شهر

يتعامل المحلّل مع هذه الاختلافات ويحسب أوقات التنفيذ التالية وفقًا لذلك.

المزالق الشائعة والحالات الطرفية

من الأخطاء الشائعة الخلط بين ترقيم أيام الأسبوع: يستخدم هذا المحلّل 0-6 (الأحد-السبت، حيث 0 هو الأحد)، بينما تستخدم بعض الأنظمة 1-7 (الاثنين-الأحد). مشكلة أخرى هي التعامل مع المنطقة الزمنية: عادةً ما تُقيَّم تعبيرات cron وفق المنطقة الزمنية للخادم، والتي قد تختلف عن منطقتك الزمنية المحلية. يستخدم يوم الشهر ويوم الأسبوع دلالات OR: إذا تم تحديدهما معًا (ليس *)، تعمل الوظيفة عندما يتحقق أي شرط منهما، وقد يكون ذلك مربكًا. على سبيل المثال، التعبير 0 9 15 * 1 يعمل عند 9 صباحًا في اليوم 15 من كل شهر أو كل يوم اثنين، وليس فقط عندما يتحقق الشرطان معًا. قد تسبب حدود الأشهر مشكلات: وظيفة cron المجدولة لليوم 31 لن تعمل في الأشهر التي تحتوي على أيام أقل. يتعامل المحلّل مع هذه الحالات الحدّية، لكن ينبغي على المطورين الانتباه لاختلافات المناطق الزمنية وشروط حدود التاريخ. يمكن أن تؤثر السنوات الكبيسة وانتقالات التوقيت الصيفي أيضًا في أوقات التنفيذ المجدولة. عند استخدام قيم الخطوة مع النطاقات، تأكد من أن الخطوة تقسم النطاق بالتساوي لتجنب سلوك غير متوقع.

متى تستخدم هذه الأداة بدلًا من الكود

استخدم محلّل cron هذا للتحقق السريع من التعبيرات، وفهم وظائف cron الموجودة، أو توليد أوصاف قابلة للقراءة البشرية. وهو مثالي لتصحيح مشكلات وظائف cron، وتوثيق المهام المجدولة، أو تعلم صياغة تعبيرات cron. أما في كود الإنتاج، فاستخدم مكتبات تحليل cron المدمجة في تطبيقك والتي يمكنها التحقق من التعبيرات، وحساب أوقات التشغيل التالية، والتكامل مع أنظمة جدولة الوظائف. توفر مكتبات cron معالجة أفضل للأخطاء، ودعمًا للمناطق الزمنية، وتكاملًا مع مجدِّلات المهام. تتفوق أدوات المتصفح في التحليل عند الطلب والتعلّم، بينما توفر الحلول المعتمدة على الكود الأتمتة، والتحقق ضمن خطوط CI/CD، والتكامل مع أطر جدولة الوظائف. بالنسبة لأنظمة الجدولة المؤسسية، توفر المكتبات الأصلية أداءً أفضل، وتعاملًا أفضل مع المناطق الزمنية، ودعمًا لميزات cron المتقدمة.