Format cron job dan zona waktu

Cron job dijadwalkan pada interval berulang, yang ditentukan menggunakan format berdasarkan unix-cron. Anda dapat menentukan jadwal agar tugas berjalan beberapa kali sehari, atau pada hari dan bulan tertentu. (Meskipun kami tidak lagi merekomendasikan penggunaannya, menjadwalkan tugas dengan membuat file cron.yaml masih didukung untuk tugas yang ada.)

Cloud Scheduler juga mendukung penjadwalan tugas menggunakan format yang lebih mudah dibaca manusia. Untuk mengetahui informasi selengkapnya, dalam dokumen ini, lihat Format tugas alternatif.

Format cron job

Anda dapat menggunakan konsol Google Cloud , Google Cloud CLI, atau REST API Cloud Scheduler untuk menetapkan jadwal.

Jadwal ditentukan menggunakan format string unix-cron (* * * * *) yang merupakan kumpulan lima kolom dalam satu baris, yang menunjukkan kapan tugas harus dijalankan.

Kolom waktu memiliki format dan kemungkinan nilai berikut, serta harus mengikuti urutan ini:

|------------------------------- Minute (0-59)
|     |------------------------- Hour (0-23)
|     |     |------------------- Day of the month (1-31)
|     |     |     |------------- Month (1-12; or JAN to DEC)
|     |     |     |     |------- Day of the week (0-6; or SUN to SAT; or 7 for Sunday)
|     |     |     |     |
|     |     |     |     |
*     *     *     *     *
Kolom Format nilai yang valid
Menit 0-59
Jam 0-23
Tanggal 1-31
Bulan 1-12 (atau JAN hingga DEC)
Hari dalam seminggu 0-6 (atau SUN hingga SAT; atau 7 untuk Sunday)
  • Menit: menunjukkan seberapa jauh tugas Anda berjalan setelah awal jam, dalam menit. Misalnya, jika menit ditetapkan ke 0, tugas akan berjalan di awal jam (karena itu adalah 0 menit setelah jam). Jadi, jika jamnya adalah 08.00, tugas akan berjalan pada pukul 08.00.

  • Hour: menunjukkan berapa jam setelah tengah malam tugas Anda berjalan, dalam jam (dibulatkan ke bawah ke jam terdekat, karena sisa menit ditunjukkan di kolom minute). Tengah malam adalah 0 dan siang hari adalah 12. Misalnya, jika jam ditetapkan ke 0, tugas akan berjalan pada tengah malam (karena itu adalah 0 jam setelah tengah malam).

  • Hari dalam sebulan: menunjukkan tanggal kalender dalam sebulan. Misalnya, 1 untuk hari pertama dalam sebulan. Cloud Scheduler tidak mendukung L untuk mengartikan hari terakhir dalam sebulan.

  • Bulan: menunjukkan bulan. Tentukan nomor bulan atau tiga huruf pertama nama bulan dalam huruf besar. Misalnya, 1 untuk Januari, atau setara dengan JAN.

  • Hari: menunjukkan hari. Misalnya, Senin adalah 1 dan Selasa adalah 2. 0 atau 7 dapat menunjukkan hari Minggu. Tentukan hari dalam seminggu berdasarkan angka atau tiga huruf pertama nama hari dalam huruf besar (misalnya SUN untuk hari Minggu).

    • Kolom ini dievaluasi sebagai OR inklusif dengan kolom day of the month, kecuali jika salah satu kolom ini ditandai sebagai tidak dibatasi oleh tanda bintang (*). Misalnya, jika hari dalam bulan ditetapkan ke 1 dan hari dalam minggu ditetapkan ke SAT, tugas akan berjalan pada hari pertama dalam bulan dan pada setiap hari Sabtu dalam bulan tersebut, meskipun hari pertama dalam bulan tersebut bukan hari Sabtu. Jika hari dalam seminggu tidak dibatasi (disetel ke *), tugas hanya akan berjalan pada hari pertama dalam sebulan.

Mencocokkan semua nilai

Untuk mencocokkan semua nilai untuk kolom, gunakan tanda bintang: *. Jika kolom ditetapkan ke tanda bintang, kolom tersebut akan cocok dengan semua nilai yang valid untuk kolom tersebut setiap kali kondisi kolom lainnya terpenuhi. Menetapkan kolom ke tanda bintang terkadang disebut sebagai membiarkan kolom tidak dibatasi, karena tidak dibatasi ke nilai tertentu.

Berikut adalah dua contoh yang kolom menitnya tidak dibatasi:

  • * 0 1 1 1: tugas berjalan setiap menit pada tengah malam tanggal 1 Januari dan hari Senin.
  • * * * * *: tugas berjalan setiap menit (setiap jam, setiap hari dalam sebulan, setiap bulan, setiap hari dalam seminggu, karena setiap kolom ini juga tidak dibatasi).

Tanda bintang setara dengan kasus khusus rentang, di mana rentang dimulai pada nilai valid pertama untuk kolom, dan berakhir pada nilai valid terakhir untuk kolom (misalnya, 0-59 untuk kolom menit).

Mencocokkan rentang

Untuk mencocokkan rentang nilai, tentukan nilai awal dan akhir, yang dipisahkan dengan tanda hubung (-). Jangan sertakan spasi dalam rentang. Rentang bersifat inklusif. Angka pertama harus lebih kecil dari angka kedua. Jika Anda menggunakan nama singkatan untuk bulan atau hari kerja (misalnya, JAN, bukan 1 untuk bulan pertama dalam setahun), nilai pertama harus muncul lebih awal dalam bulan atau minggu daripada nilai kedua.

Contoh setara berikut berjalan pada tengah malam pada hari Senin, Selasa, Rabu, Kamis, dan Jumat (untuk semua bulan):

  • 0 0 * * 1-5
  • 0 0 * * MON-FRI

Mencocokkan daftar

Daftar dapat berisi nilai valid apa pun untuk kolom, termasuk rentang. Tentukan nilai Anda, yang dipisahkan dengan koma (,). Jangan sertakan spasi dalam daftar.

Contoh:

  • 0 0,12 * * *: tugas berjalan pada tengah malam dan tengah hari.
  • 0-5,30-35 * * * *: tugas berjalan di setiap lima menit pertama setiap setengah jam (di awal jam dan di setengah jam).

Melewati nilai dalam rentang

Anda dapat melewati nilai dalam rentang dengan menentukan kecepatan untuk melangkah melalui rentang tersebut. Hal ini terkadang disebut sebagai penggunaan fungsi langkah (atau nilai langkah atau ekspresi tarif). Untuk melakukannya, tentukan rentang, diikuti dengan garis miring (/) dan kecepatan yang Anda inginkan untuk melewati rentang tersebut.

Anda dapat menggunakan tanda bintang (*) untuk menunjukkan rentang semua nilai untuk kolom. Saat Anda menggunakan tanda bintang, nilai pertama dalam rentang adalah: 0 untuk kolom menit, jam, dan hari dalam seminggu (Minggu), serta 1 untuk kolom hari dalam sebulan dan bulan.

Nilai langkah tidak boleh lebih besar dari nilai terbesar yang mungkin untuk kolom tersebut. Langkah defaultnya adalah 1, sehingga fungsi langkah /1 sama dengan tidak menggunakan fungsi langkah sama sekali.

Contoh rentang yang menggunakan fungsi langkah:

  • */2: ini adalah fungsi langkah yang valid untuk kolom apa pun. Untuk kolom menit, nilai yang cocok adalah 0, 2, 4, ... , 58. Untuk jam, cocok dengan 0, 2, 4, ... , 22. Untuk hari dalam sebulan, cocok dengan 1, 3, 5, ... , 31 (untuk bulan dengan 31 hari). Untuk bulan, cocok dengan 1, 3, 5, ... , 11. Untuk hari dalam seminggu, cocok dengan 0, 2, 4, 6.

  • 0-12/2: ini adalah fungsi langkah yang valid untuk kolom menit dan jam. Nilai ini cocok dengan 0, 2, 4, ... , 12.

Contoh jadwal yang menggunakan fungsi langkah:

  • */2 * * * *: tugas berjalan setiap dua menit.

  • 0 0-12/2 * * *: tugas berjalan setiap dua jam, tepat pada jamnya. Proses pertama adalah pada tengah malam. Kereta terakhir berangkat pada tengah hari.

Contoh jadwal

Tabel berikut menunjukkan beberapa contoh jadwal cron job dan deskripsinya:

Jadwal Format cron job Penjelasan
Setiap menit * * * * * Berjalan setiap menit. Misalnya, 09.00, 09.01, 09.02, dan seterusnya.
Setiap jam 0 * * * * Berjalan setiap jam. Misalnya, 09.00, 10.00, 11.00, dan seterusnya.
Setiap hari 0 0 * * * Dijalankan pada pukul 12.00 AM (00.00 dalam format 24 jam) setiap hari.
Setiap hari kerja
(Sen-Jum)
Berikut ini adalah hal yang setara:
  • 0 0 * * 1-5
  • 0 0 * * MON-FRI
Dijalankan pada pukul 12.00 AM (00.00 dalam format 24 jam) pada hari Senin, Selasa, Rabu, Kamis, dan Jumat.
Setiap minggu Berikut ini adalah hal yang setara:
  • 0 0 * * 0
  • 0 0 * * 7
  • 0 0 * * SUN
Dijalankan pada hari Minggu pukul 00.00 (00.00 dalam format 24 jam).
Setiap bulan 0 0 1 * * Dijalankan pada pukul 00.00 (00.00 dalam format 24 jam) pada hari pertama setiap bulan.
Setiap kuartal Berikut ini adalah hal yang setara:
  • 0 0 1 1,4,7,10 *
  • 0 0 1 JAN,APR,JUL,OCT *
Berjalan pada pukul 00.00 (00.00 dalam format 24 jam) pada hari pertama kuartal, untuk jadwal kuartalan standar: 1 Januari, 1 April, 1 Juli, dan 1 Oktober.
Setiap tahun Berikut ini adalah hal yang setara:
  • 0 0 1 1 *
  • 0 0 1 JAN *
Dijalankan pada pukul 00.00 (00.00 dalam format 24 jam) pada hari pertama bulan pertama dalam setahun (1 Januari).

Zona waktu

Anda dapat memilih zona waktu untuk mengevaluasi jadwal di Google Cloud konsol (di halaman Create a job, pilih Timezone dari daftar), atau melalui flag gcloud --time-zone saat Anda membuat tugas.

Nilai kolom ini harus berupa singkatan zona waktu yang digunakan dalam database tz. Zona waktu default adalah UTC.

Untuk beberapa zona waktu, waktu musim panas dapat menyebabkan tugas berjalan atau tidak berjalan secara tidak terduga. Hal ini karena Cloud Scheduler berjalan berdasarkan waktu jam dinding. Dalam kasus saat waktu dapat terjadi dua kali (seperti saat jam mundur) dan tugas Anda dijadwalkan pada waktu ini, tugas terjadwal Anda mungkin mengalami anomali eksekusi.

Jika tugas Anda memerlukan ritme yang sangat spesifik, sebaiknya pilih zona waktu yang tidak menerapkan waktu musim panas. Secara khusus, UTC direkomendasikan untuk Cloud Scheduler guna menghindari masalah sepenuhnya.

Format lowongan alternatif

Anda dapat menggunakan format spesifikasi waktu yang lebih mudah dibaca manusia, yang dikenal sebagai groc, yang memberikan alternatif untuk ekspresi cron. Misalnya, beberapa peristiwa berulang mungkin sulit ditentukan menggunakan cron seperti "Selasa ketiga setiap bulan" atau "dua mingguan" (setiap 336 jam). Dalam kasus seperti ini, Anda dapat menggunakan konstruksi seperti contoh berikut:

03 of month 12:34
1,3,4,7,11,18,29 of jan,jul 12:34
1st friday of quarter 9:00
1st,third monday of month 04:00
2nd,3rd tue,wed,thu of feb,aug 13:50
every 336 hours
every 48 hours
every 5 minutes
every 60 minutes on mon,wed
every day 09:00
every minute
every sun,tue,thu 9:00
every wed of december 00:00
first sunday of month 12:00
second,4th tue,thursday of 3rd month of quarter 18:30

Saat menentukan jadwal tugas menggunakan groc, Anda harus menggunakan gcloud CLI atau membuat permintaan langsung ke Cloud Scheduler API.

Untuk mengetahui informasi selengkapnya tentang sintaksis, lihat Menentukan jadwal cron job.

Langkah berikutnya