Pengurai Ekspresi Cron

Uraian setiap field

Sebuah field bukan satu nilai, melainkan satu himpunan nilai. Mengetahui seberapa besar himpunan itu biasanya sudah menjawab pertanyaan yang membawa Anda ke sini.

Operator di dalam satu field: * semua nilai, 1,5,10 sebuah daftar, 1-5 sebuah rentang, */15 sebuah langkah yang dihitung dari awal rentang, dan 0-45/15 sebuah langkah di dalam rentang.

Nama dan singkatan juga diterima

Nama bulan dan nama hari dalam minggu bisa dibaca, lalu diuraikan menjadi angka yang dicocokkannya, jadi 30 3 * JAN,JUL 1 melaporkan bulan 1, 7 dan hari dalam minggu 1. Singkatan bernama diuraikan lebih dulu ke bentuk 5 field-nya sebelum hal lain diproses:

@reboot juga dikenali, tetapi tidak ada jadwal yang bisa diuraikan: ia berjalan sekali saat mesin dinyalakan, jadi tidak ada waktu eksekusi yang bisa dipratinjau.

Peringatan yang perlu dibaca

• Dua field hari sama-sama dibatasi. 0 0 1 * MON bukan berarti “tanggal 1, tetapi hanya kalau tanggal itu jatuh pada hari Senin”. Cron standar memperlakukan dua field hari itu sebagai OR ketika keduanya dibatasi, jadi baris tersebut berjalan setiap tanggal 1 dan setiap hari Senin. Pengurai memunculkan peringatan ini, dan pratinjau waktu eksekusinya mengikuti aturan OR yang sama.
• Tanggal yang tidak pernah ada. 0 0 30 2 * meminta tanggal 30 Februari. Ekspresinya sah secara sintaksis dan cron akan menerimanya, tetapi tugasnya tidak akan pernah berjalan. Pengurai menyatakannya terus terang, alih-alih menampilkan daftar kosong tanpa penjelasan.
• Operator Quartz. L (terakhir), W (hari kerja terdekat), # (hari dalam minggu ke-n) dan ? adalah ekstensi Quartz, bukan crontab standar. Di dalam baris 5 field, operator-operator itu dikenali dan ditandai, lalu field yang bersangkutan menunjukkan bahwa isinya operator Quartz, bukan daftar nilai. Waktu eksekusi tidak dihitung, karena cron standar memang tidak akan menjalankan baris itu sama sekali.

Apa yang langsung ditolak

• Jumlah field yang salah. Baris Quartz 6 field yang memakai detik, atau baris 7 field yang memakai tahun, ditolak karena jumlah field-nya.
• Nilai di luar rentang, misalnya menit 75 atau bulan 13.
• Rentang menurun seperti 5-1.
• Langkah nol, seperti */0.

Setiap penolakan menyebutkan field dan nilai yang menyebabkannya, jadi Anda cukup memperbaiki satu hal, bukan menulis ulang seluruh baris.

Zona waktu

Pratinjau eksekusi berikutnya dihitung di browser Anda, dalam zona waktu yang disetel pada perangkat Anda (WIB adalah UTC+7, WITA UTC+8, dan WIT UTC+9). Sebuah crontab berjalan mengikuti zona waktu mesin yang menjalankannya, jadi kalau server itu memakai UTC sementara perangkat Anda tidak, geser dulu waktunya sebelum membandingkan.