DevToolPal
ไทย

นิพจน์ Cron

ทุกปี

รันปีละครั้งเวลา 00:00 วันที่ 1 มกราคม เหมือน @yearly และ @annually

0 0 1 1 * เปิดในเครื่องมือแยกวิเคราะห์ Cron

ทีละฟิลด์

ฟิลด์ ค่า ตรงกับ
นาที 0 0
ชั่วโมง 0 0
วันที่ 1 1
เดือน 1 มกราคม
วันในสัปดาห์ * ทุกค่า

เวลารันครั้งถัดไป

ตัวอย่าง: การรัน 6 ครั้งแรกหลัง 1 มกราคม 2569 (UTC)

  1. ศุกร์ 1 ม.ค. 2570 00:00
  2. เสาร์ 1 ม.ค. 2571 00:00
  3. จันทร์ 1 ม.ค. 2572 00:00
  4. อังคาร 1 ม.ค. 2573 00:00
  5. พุธ 1 ม.ค. 2574 00:00
  6. พฤหัส 1 ม.ค. 2575 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 timer ที่ตั้ง Persistent=true

› 0 0 1 1 * รันตามเขตเวลาใด

Cron ใช้เขตเวลาของเครื่องหรือบริการที่รันมัน บน Linux คือเขตเวลาของระบบ เว้นแต่ตั้ง CRON_TZ หรือ TZ; CronJob ของ Kubernetes รองรับ spec.timeZone; GitHub Actions ใช้ UTC เสมอ

› จะตรวจสอบตารางเวลานี้ก่อนนำไปใช้จริงได้อย่างไร

เปิด 0 0 1 1 * ในเครื่องมือแยกวิเคราะห์ Cron ของเว็บไซต์นี้ เครื่องมือจะอธิบายแต่ละฟิลด์และแสดงเวลารันที่จะมาถึงตามเวลาท้องถิ่นหรือ UTC ทั้งหมดในเบราว์เซอร์