Ekspresi Cron - Elastic Compute Service

Dokumen ini menjelaskan cara menggunakan ekspresi cron untuk menentukan jadwal pelaksanaan perintah Cloud Assistant di konsol Elastic Compute Service (ECS) atau melalui pemanggilan API. Topik ini mencakup sintaksis dasar dan contoh penggunaan ekspresi cron.

Sintaksis Dasar Ekspresi Cron

Ekspresi cron adalah string yang mendefinisikan jadwal untuk menjalankan suatu pekerjaan. String ini terdiri dari enam atau tujuh bidang waktu.

Format umum ekspresi cron adalah sebagai berikut:

<Detik> <Menit> <Jam> <Hari-bulan> <Hari-minggu> <Bulan> <Tahun>

<Tahun>: Bidang ini bersifat opsional.
Perhatikan hal-hal berikut mengenai setiap bidang:
- Setiap bidang dapat berisi nilai spesifik, rentang, penambahan, atau karakter khusus.
- Pisahkan beberapa nilai dalam satu bidang dengan koma (,).
- Setiap bidang mendukung maksimal satu nol di depan. Contohnya, 01 dan 02 diperbolehkan, tetapi 001 dan 002 tidak.

Untuk informasi lebih lanjut tentang rentang nilai dan karakter khusus yang didukung oleh bidang dalam ekspresi cron, lihat bagian Nilai Valid Bidang dan Contoh.

Nilai Valid Bidang

Tabel berikut menjelaskan rentang nilai valid dan karakter khusus yang didukung oleh masing-masing bidang dalam ekspresi cron.

Bidang	Wajib	Rentang Nilai	Karakter Khusus yang Didukung
Detik	Ya	[0, 59]	* , - /
Menit	Ya	[0, 59]	* , - /
Jam	Ya	[0, 23]	* , - /
Hari-bulan	Ya	[1, 31]	* , - / ? L W
Bulan	Ya	[1, 12] atau [JAN, DEC]	* , - /
Hari-minggu	Ya	[1, 7] atau [SEN, MIN]. Untuk perintah Cloud Assistant, `1` dalam [1, 7] menunjukkan Senin dan `7` menunjukkan Minggu. Penting Penggunaan dan makna ekspresi cron dapat bervariasi berdasarkan sistem, framework, atau alat. Dalam skenario selain perintah Cloud Assistant, makna 1 dan 7 dalam [1, 7] mungkin berbeda. 1 mungkin menunjukkan Minggu dan 7 mungkin menunjukkan Sabtu.	* , - / ? L #
Tahun	Tidak	[Tahun Saat Ini, 2099]	* , - /

Karakter Khusus

Setiap bidang dalam ekspresi cron mendukung karakter khusus dengan makna tertentu.

Karakter Khusus	Makna	Contoh
`*`	Mencakup semua nilai.	Dalam bidang `Bulan`, asterisk (`*`) mencakup setiap bulan.
`,`	Mencakup nilai tambahan.	Dalam bidang `Menit`, `5,20` menandakan menit ke-5 dan ke-20 dari jam.
`-`	Menentukan rentang.	Dalam bidang `Menit`, `5-20` menandakan menit ke-5 hingga menit ke-20 dari jam.
`/`	Menentukan penambahan.	Dalam bidang `Menit`, `0/15` menandakan setiap 15 menit, dimulai tepat pada jam. Dalam bidang `Menit`, `3/20` menandakan setiap 20 menit, dimulai dari menit ke-3 dari jam.
`?`	Menentukan nilai sembarang dan hanya dapat digunakan dalam bidang Hari-bulan dan Hari-minggu.	Jika Anda menentukan nilai dalam salah satu bidang `Hari-bulan` dan `Hari-minggu`, masukkan tanda tanya (`?`) di bidang lainnya untuk menghindari konflik tanggal.
`L`	Dapat digunakan dalam bidang `Hari-bulan` atau `Hari-minggu` untuk menentukan hari terakhir dalam sebulan atau minggu. Penting Untuk mencegah kesalahan logika, jangan tentukan daftar atau rentang nilai ketika menggunakan karakter `L`.	Dalam bidang `Hari-bulan`, `L` menandakan hari terakhir dalam sebulan. Dalam bidang `Hari-minggu`, `L` menandakan hari terakhir dalam minggu, yaitu Minggu (`MIN`). `L` dapat digunakan dengan nilai lain. Sebagai contoh, dalam bidang `Hari-minggu`, `6L` menandakan Sabtu terakhir dalam sebulan.
`W`	Menentukan hari kerja yang paling dekat dengan hari tertentu dalam sebulan. Hari kerja yang ditandai oleh karakter `W` berada dalam bulan yang sama dengan hari tertentu dalam sebulan. `LW` menandakan hari kerja terakhir dalam bulan yang ditentukan.	Jika Anda menentukan `5W` dalam bidang `Hari-bulan` dan hari ke-5 dalam sebulan jatuh pada hari Sabtu, tugas akan dipicu pada hari Jumat terdekat, yaitu hari ke-4 dalam sebulan. Jika hari ke-5 dalam sebulan jatuh pada hari Minggu, tugas akan dipicu pada hari Senin terdekat, yaitu hari ke-6 dalam sebulan. Jika hari ke-5 dalam sebulan jatuh pada hari kerja, tugas akan dipicu pada hari ke-5 dalam sebulan.
`#`	Menentukan hari tertentu dalam minggu dalam sebulan. Penting Karakter ini hanya dapat digunakan dalam bidang `Hari-minggu`.	Dalam bidang `Hari-minggu`, `4#2` menandakan Kamis kedua dalam sebulan.

Contoh

Skenario		Nilai
Jalankan tugas pada waktu tertentu setiap hari.	Jalankan tugas pada pukul 10:15 setiap hari.	`0 15 10 ? * *`
Jalankan tugas pada waktu tertentu setiap hari.	Jalankan tugas pada pukul 12:00 setiap hari.	`0 0 12 * * ?`
Jalankan tugas pada waktu-waktu tertentu setiap hari.	Jalankan tugas pada pukul 10:00, 14:00, dan 16:00 setiap hari.	`0 0 10,14,16 * * ?`
Jalankan tugas pada interval tetap.	Jalankan tugas setiap setengah jam dari pukul 09:00 hingga 17:00 setiap hari.	`0 0/30 9-17 * * ?`
	Jalankan tugas setiap menit dari pukul 14:00 hingga 14:59 setiap hari.	`0 * 14 * * ?`
	Jalankan tugas setiap menit dari pukul 14:00 hingga 14:05 setiap hari.	`0 0-5 14 * * ?`
	Jalankan tugas setiap 5 menit dari pukul 14:00 hingga 14:55 setiap hari.	`0 0/5 14 * * ?`
	Jalankan tugas setiap 5 menit dari pukul 14:00 hingga 14:55 dan dari pukul 18:00 hingga 18:55 setiap hari.	`0 0/5 14,18 * * ?`
Jalankan tugas pada hari-hari tertentu dalam sebulan atau minggu.	Jalankan tugas pada pukul 12:00 setiap Rabu.	`0 0 12 ? * RAB`
	Jalankan tugas pada pukul 10:15 pada hari ke-15 setiap bulan.	`0 15 10 15 * ?`
	Jalankan tugas pada pukul 10:15 pada hari terakhir setiap bulan.	`0 15 10 L * ?`
	Jalankan tugas pada pukul 10:15 pada Sabtu terakhir setiap bulan.	`0 15 10 ? * 6L`
	Jalankan tugas pada pukul 10:15 pada Sabtu ketiga setiap bulan.	`0 15 10 ? * 6#3`
Jalankan tugas pada hari-hari tertentu dalam tahun-tahun tertentu.	Jalankan tugas pada pukul 14:10 dan 14:44 setiap Rabu di bulan Maret setiap tahun.	`0 10,44 14 ? 3 RAB`
	Jalankan tugas pada pukul 10:15 setiap hari di tahun 2022.	`0 15 10 ? * * 2022`
	Jalankan tugas pada pukul 10:15 setiap hari setiap tahun.	`0 15 10 ? * * *`
	Jalankan tugas setiap 5 menit dari pukul 14:00 hingga 14:55 dan dari pukul 18:00 hingga 18:55 setiap hari di tahun 2022.	`0 0/5 14,18 * * ? 2022`
	Jalankan tugas pada pukul 10:15 pada Sabtu ketiga setiap bulan di tahun 2022 dan 2023.	`0 15 10 ? * 6#3 2022,2023`
	Jalankan tugas setiap setengah jam dari pukul 9:00 hingga 17:30 setiap hari di tahun 2022 hingga 2025.	`0 0/30 9-17 * * ? 2022-2025`
	Jalankan tugas pada pukul 14:10 dan 14:44 setiap Rabu di bulan Maret setiap 2 tahun mulai dari tahun 2022.	`0 10,44 14 ? 3 RAB 2022/2`