DevToolPal
ع

تعبير Cron

أول يوم من كل شهر

يعمل عند 00:00 في اليوم الأول من كل شهر. مثل الماكرو @monthly.

0 0 1 * * افتح في محلّل تعبيرات Cron

شرح كل حقل

الحقل القيمة يطابق
الدقيقة 0 0
الساعة 0 0
يوم الشهر 1 1
الشهر * كل القيم
يوم الأسبوع * كل القيم

أوقات التشغيل القادمة

مثال: أول 6 مرات تشغيل بعد 1 يناير 2026 (UTC).

  1. الأحد، 1 فبراير 2026، 00:00
  2. الأحد، 1 مارس 2026، 00:00
  3. الأربعاء، 1 أبريل 2026، 00:00
  4. الجمعة، 1 مايو 2026، 00:00
  5. الاثنين، 1 يونيو 2026، 00:00
  6. الأربعاء، 1 يوليو 2026، 00:00

نسخ جاهزة للاستخدام

crontab
0 0 1 * * /path/to/command

أضف السطر باستخدام crontab -e. يعمل وفق المنطقة الزمنية للخادم ما لم يُضبط CRON_TZ أو TZ.

Kubernetes CronJob
apiVersion: batch/v1
kind: CronJob
metadata:
  name: first-day-of-month
spec:
  schedule: "0 0 1 * *"
  timeZone: "Etc/UTC"
  concurrencyPolicy: Forbid
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: job
              image: busybox:1.36
              command: ["/bin/sh", "-c", "date; echo run"]

اضبط spec.timeZone (‏Kubernetes 1.27 فأحدث)؛ وبدونه يتبع الجدول المنطقة الزمنية لـ controller manager، وهي UTC غالبًا.

GitHub Actions
on:
  schedule:
    - cron: '0 0 1 * *'
  workflow_dispatch:

يستخدم GitHub Actions توقيت UTC دائمًا، ويقبل فواصل لا تقل عن 5 دقائق، وقد يتأخر بدء التشغيل المجدول عند الضغط.

Quartz
0 0 0 1 * ?

يضع Quartz الثواني أولًا ويتطلب ? في يوم الشهر أو يوم الأسبوع. تُرقَّم الأيام من 1 إلى 7 بدءًا من الأحد، لذا فالأسماء أكثر أمانًا.

Spring
@Scheduled(cron = "0 0 0 1 * *")

يستخدم Spring ‏@Scheduled(cron = …) ستة حقول: الثواني ثم الحقول الخمسة المعتادة.

الأسئلة الشائعة

› كيف أشغّله في أول يوم عمل من الشهر؟

لا يستطيع cron التعبير عن ذلك مباشرة. شغّله في الأيام 1-3 (0 9 1-3 * *) ودع السكربت يتحقق مما إذا كان أول يوم عمل.

› بأي منطقة زمنية يعمل 0 0 1 * *؟

يستخدم cron المنطقة الزمنية للجهاز أو الخدمة التي تشغّله. في لينكس هي منطقة النظام ما لم يُضبط CRON_TZ أو TZ؛ وتقبل CronJob في Kubernetes الحقل spec.timeZone؛ ويستخدم GitHub Actions توقيت UTC دائمًا.

› كيف أتحقق من هذا الجدول قبل النشر؟

افتح 0 0 1 * * في محلّل تعبيرات Cron على هذا الموقع. يشرح كل حقل ويعرض أوقات التشغيل القادمة بتوقيتك المحلي أو بتوقيت UTC، داخل المتصفح مباشرة.