DevToolPal
ع

تعبير Cron

كل سنة

يعمل مرة في السنة عند 00:00 يوم 1 يناير. مثل @yearly و@annually.

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

شرح كل حقل

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

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

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

  1. الجمعة، 1 يناير 2027، 00:00
  2. السبت، 1 يناير 2028، 00:00
  3. الاثنين، 1 يناير 2029، 00:00
  4. الثلاثاء، 1 يناير 2030، 00:00
  5. الأربعاء، 1 يناير 2031، 00:00
  6. الخميس، 1 يناير 2032، 00:00

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

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

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

Kubernetes CronJob
apiVersion: batch/v1
kind: CronJob
metadata:
  name: every-year
spec:
  schedule: "0 0 1 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 1 *'
  workflow_dispatch:

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

Quartz
0 0 0 1 1 ?

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

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

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

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

› هل cron موثوق للمهام السنوية؟

إذا كان الجهاز مطفأً في تلك اللحظة يضيع التشغيل. للمهام التي يجب تعويضها استخدم anacron أو مؤقّت systemd مع Persistent=true.

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

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

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

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