Generator Cron Expression

Apa itu cron expression?

Cron expression adalah cara ringkas untuk menuliskan jadwal yang berulang. Sintaksnya sama dengan yang dipakai cron di Unix, penjadwal asli Linux, dan sudah menyebar ke hampir semua job runner yang akan kamu temui: Kubernetes CronJob, jadwal GitHub Actions, AWS EventBridge, Cloudflare Workers, Vercel cron, dan sebagian besar platform CI/CD.

Formatnya terlihat menakutkan, padahal sebenarnya hanya lima field yang dipisahkan spasi: menit, jam, tanggal, bulan, dan hari dalam seminggu. Setiap field berisi angka, daftar (1,15), rentang (9-17), langkah (*/5), atau wildcard (*). Alat cron yang bagus mengubah expression menjadi kalimat biasa dan menampilkan waktu jalan berikutnya, supaya kamu bisa memeriksanya sebelum deploy.

Beberapa platform memperluas sintaks dasar 5 field dengan field *detik* di depan (Quartz, Spring, Kubernetes 6 field) atau field *tahun* di belakang. Selalu cek format mana yang diterima penjadwalmu sebelum menempel sebuah expression.

Yang akan kamu pelajari saat membuat jadwal cron

• Cron expression standar punya 5 field: menit, jam, tanggal, bulan, dan hari dalam seminggu.
• * berarti "setiap nilai" untuk field itu. Inilah penyebab paling umum jadwal berjalan lebih sering dari yang diharapkan.
• */N berarti "setiap N satuan": */5 di field menit berarti "setiap 5 menit".
• Tanggal dan hari dalam seminggu saling memengaruhi: mengisi keduanya mempersempit jadwal, tapi di cron Unix klasik, mengisi salah satunya dengan * sementara yang lain spesifik adalah cara yang lebih aman untuk menulis aturan khusus hari kerja atau khusus bulanan.

Cara menulis cron expression langkah demi langkah

1. 1

   Mulai dari preset

   Pilih preset yang paling dekat dengan yang kamu inginkan: setiap menit, setiap jam, setiap hari pukul 09.00, hari kerja pukul 09.00, atau bulanan (Every minute, Hourly, Daily at 9 AM, Weekdays at 9 AM, Monthly). Expression-nya muncul di editor.

2. 2

   Sesuaikan setiap field

   Edit menit, jam, tanggal, bulan, dan hari dalam seminggu. Pakai * untuk nilai apa pun, daftar dengan koma, rentang (9-17), atau langkah (*/15).

3. 3

   Baca penjelasannya

   Alat ini mengubah expression-mu menjadi sebuah kalimat, misalnya "Pukul 09:00 pada hari kerja" (At 09:00 every weekday). Kalau kalimatnya tidak sesuai dengan yang kamu inginkan, berarti expression-nya salah.

4. 4

   Lihat jadwal jalan berikutnya

   Periksa 5 sampai 10 waktu jalan berikutnya dalam zona waktu lokalmu. Waspadai perpindahan daylight saving time kalau jadwalnya dekat dengan waktu perubahan itu.

5. 5

   Salin ke penjadwalmu

   Masukkan expression ke crontab, workflow GitHub Actions, Kubernetes CronJob, atau penjadwal apa pun yang kamu pakai.

Referensi cepat field cron

Lima field cron expression standar, sesuai urutannya. Referensi: man page crontab(5) POSIX.

Contoh cron expression untuk dicoba

Kesalahan umum saat memakai cron

• Lupa zona waktu. Kebanyakan daemon cron berjalan di zona waktu *server*, bukan zona waktumu. Atur zona waktu secara eksplisit kalau platformnya mendukung.
• Mengisi tanggal dan hari dalam seminggu sekaligus. Di cron Unix klasik, jadwal berjalan pada hari yang cocok dengan *salah satunya*, dan ini mengejutkan kebanyakan orang saat pertama kali.
• Memakai */45 dan berharap jadwal berjalan setiap 45 menit. Nilai langkah dihitung dari 0, jadi */45 berjalan di menit 0 dan 45, bukan dengan interval 45 menit yang sesungguhnya.
• Tidak melihat jadwal jalan berikutnya sebelum deploy. Cron expression yang hampir benar bisa berjalan 60× lebih sering dari yang dimaksud.
• Lupa perpindahan daylight saving time. Jadwal 0 2 * * * bisa berjalan dua kali di hari jam dimundurkan, dan tidak berjalan sama sekali saat jam dimajukan.

FAQ Cron Expression