Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Format cron job dan zona waktu

Cron job dijadwalkan pada interval berulang, yang ditentukan menggunakan format berdasarkan pada 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 a tugas dengan membuat file cron.yaml masih didukung untuk tugas yang ada.)

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

Format cron job

Anda dapat menggunakan Google Cloud konsol, Google Cloud CLI, atau Cloud Scheduler REST API 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 nilai yang mungkin berikut, dan 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 DES)
Hari dalam seminggu	0-6 (atau MING hingga SAB; atau 7 untuk Minggu)

Menit: menunjukkan seberapa jauh tugas Anda berjalan setelah awal jam, dalam menit. Misalnya, jika menit ditetapkan ke 0, tugas akan berjalan pada awal jam (karena 0 menit setelah jam). Jadi, jika jamnya pukul 08.00, tugas akan berjalan pada pukul 08.00.
Jam: menunjukkan seberapa jauh tugas Anda berjalan setelah tengah malam, dalam jam (dibulatkan ke bawah ke jam terdekat, karena menit yang tersisa ditunjukkan di kolom minute). Tengah malam adalah 0 dan tengah hari adalah 12. Misalnya, jika jam ditetapkan ke 0, tugas akan berjalan pada jam tengah malam (karena 0 jam setelah tengah malam).
Tanggal: menunjukkan tanggal kalender dalam sebulan. Misalnya, 1 untuk hari pertama dalam sebulan. Cloud Scheduler tidak mendukung L yang berarti 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 dalam seminggu: menunjukkan hari dalam seminggu. 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 kerja dalam huruf besar (misalnya SUN untuk Minggu).
- Kolom ini dievaluasi sebagai OR inklusif dengan kolom day of the month, kecuali jika salah satu kolom ini ditandai sebagai tidak dibatasi dengan tanda bintang (*). Misalnya, jika hari dalam sebulan ditetapkan ke 1 dan hari dalam seminggu ditetapkan ke SAT, tugas akan berjalan pada hari pertama dalam sebulan dan setiap hari Sabtu dalam sebulan, meskipun hari pertama dalam sebulan bukan hari Sabtu. Jika hari dalam seminggu tidak dibatasi (ditetapkan ke *), tugas hanya 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 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 dua contoh kolom menit yang tidak dibatasi:

* 0 1 1 1: tugas berjalan setiap menit pada jam tengah malam pada 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, dengan rentang dimulai dari 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 yang valid untuk kolom, termasuk rentang. Tentukan nilai, 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 dalam lima menit pertama setiap setengah jam (pada awal jam dan pada setengah jam setelah jam).

Melewatkan nilai dalam rentang

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

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

Nilai langkah tidak boleh lebih besar dari nilai terbesar yang mungkin untuk kolom. Langkah default 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, cocok dengan 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. Cocok dengan 0, 2, 4, ... , 12.

Contoh jadwal menggunakan fungsi langkah:

*/2 * * * *: tugas berjalan setiap dua menit.
0 0-12/2 * * *: tugas berjalan setiap dua jam, pada awal jam. Jadwal pertama adalah pada tengah malam. Jadwal terakhir adalah 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 seterusn ya.
Setiap hari	`0 0 * * *`	Berjalan pada pukul 00.00 (00.00 dalam format 24 jam) setiap hari.
Setiap hari kerja (Sen-Jum)	Berikut ini setara: `0 0 * * 1-5` `0 0 * * MON-FRI`	Berjalan pada pukul 00.00 (00.00 dalam format 24 jam) pada hari Senin, Selasa, Rabu, Kamis, dan Jumat.
Setiap minggu	Berikut ini setara: `0 0 * * 0` `0 0 * * 7` `0 0 * * SUN`	Berjalan pada hari Minggu pukul 00.00 (00.00 dalam format 24 jam).
Setiap bulan	`0 0 1 * *`	Berjalan pada pukul 00.00 (00.00 dalam format 24 jam) pada hari pertama dalam sebulan.
Setiap kuartal	Berikut ini 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 dalam kuartal, untuk jadwal kuartalan standar: 1 Januari, 1 April, 1 Juli 1, dan 1 Oktober.
Setiap tahun	Berikut ini setara: `0 0 1 1 ` `0 0 1 JAN `	Berjalan pada pukul 00.00 (00.00 dalam format 24 jam) pada hari pertama dalam bulan pertama dalam setahun (1 Januari).

Zona waktu

Anda dapat memilih zona waktu untuk mengevaluasi jadwal di Google Cloud konsol (di halaman Buat tugas, pilih Zona waktu 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 pada waktu jam dinding. Dalam kasus ketika 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 irama yang sangat spesifik, sebaiknya pertimbangkan untuk memilih zona waktu yang tidak menggunakan waktu musim panas. Secara khusus, UTC direkomendasikan untuk Cloud Scheduler guna menghindari masalah sepenuhnya.

Format tugas alternatif

Anda dapat menggunakan format spesifikasi waktu yang lebih mudah dibaca yang dikenal sebagai groc yang menyediakan alternatif untuk ekspresi cron.

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

Misalnya, beberapa acara berulang mungkin sulit ditentukan menggunakan cron seperti "Selasa ketiga setiap bulan" atau "dua mingguan" (setiap 336 jam). Dalam kasus seperti itu, 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

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