Indeks
DateTime
Merepresentasikan waktu sipil (atau terkadang waktu fisik).
Jenis ini dapat mewakili waktu sipil dengan salah satu dari beberapa kemungkinan cara:
- Jika utc_offset ditetapkan dan time_zone tidak ditetapkan: waktu sipil pada hari kalender dengan offset tertentu dari UTC.
- Jika time_zone ditetapkan dan utc_offset tidak ditetapkan: waktu sipil pada hari kalender di zona waktu tertentu.
- Jika time_zone atau utc_offset tidak ditetapkan: waktu sipil pada hari kalender dalam waktu lokal.
Tanggal ini terkait dengan Kalender Gregorius Proleptik.
Jika tahun, bulan, atau hari adalah 0, DateTime dianggap tidak memiliki tahun, bulan, atau hari tertentu.
Jenis ini juga dapat digunakan untuk merepresentasikan waktu fisik jika semua kolom tanggal dan waktu ditetapkan dan salah satu kasus oneof time_offset ditetapkan. Pertimbangkan untuk menggunakan pesan Timestamp untuk waktu fisik. Jika kasus penggunaan Anda juga ingin menyimpan zona waktu pengguna, hal itu dapat dilakukan di kolom lain.
Jenis ini lebih fleksibel daripada yang mungkin diinginkan oleh beberapa aplikasi. Pastikan untuk mendokumentasikan dan memvalidasi batasan aplikasi Anda.
| Kolom | |
|---|---|
year |
Opsional. Tahun. Harus dari 1 hingga 9999, atau 0 jika menentukan tanggal waktu tanpa tahun. |
month |
Opsional. Bulan. Harus dari 1 hingga 12, atau 0 jika menentukan tanggal waktu tanpa bulan. |
day |
Opsional. Hari. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 jika menentukan tanggal waktu tanpa hari. |
hours |
Opsional. Jam dalam format 24 jam. Harus antara 0 hingga 23, defaultnya 0 (tengah malam). API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis. |
minutes |
Opsional. Menit dalam jam. Harus antara 0 hingga 59, default-nya adalah 0. |
seconds |
Opsional. Detik menit dari waktu. Biasanya harus berkisar antara 0 sampai 59, default-nya adalah 0. API dapat mengizinkan nilai 60 jika memungkinkan detik kabisat. |
nanos |
Opsional. Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999, default-nya adalah 0. |
Kolom union time_offset. Opsional. Menentukan selisih waktu UTC atau zona waktu DateTime. Pilih dengan cermat di antara keduanya, dengan mempertimbangkan bahwa data zona waktu dapat berubah di masa mendatang (misalnya, suatu negara mengubah tanggal mulai/akhir DST, dan DateTime mendatang dalam rentang yang terpengaruh telah disimpan). Jika dihilangkan, DateTime dianggap dalam waktu setempat. time_offset hanya ada berupa salah satu diantara berikut: |
|
utc_offset |
Offset UTC. Harus berupa detik utuh, antara -18 jam dan +18 jam. Misalnya, offset UTC -4:00 akan direpresentasikan sebagai { seconds: -14400 }. |
time_zone |
Zona waktu. |
Expr
Merepresentasikan ekspresi tekstual dalam sintaksis Common Expression Language (CEL). CEL adalah bahasa ekspresi mirip C. Sintaksis dan semantik CEL didokumentasikan di https://github.com/google/cel-spec.
Contoh (Perbandingan):
title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"
Contoh (Kesetaraan):
title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"
Contoh (Logika):
title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"
Contoh (Manipulasi Data):
title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"
Variabel dan fungsi yang tepat yang dapat direferensikan dalam ekspresi ditentukan oleh layanan yang mengevaluasinya. Lihat dokumentasi layanan untuk informasi tambahan.
| Kolom | |
|---|---|
expression |
Representasi tekstual ekspresi dalam sintaksis Common Expression Language. |
title |
Opsional. Judul untuk ekspresi, yaitu string singkat yang menjelaskan tujuannya. Ini dapat digunakan, misalnya, di UI yang memungkinkan untuk memasukkan ekspresi. |
description |
Opsional. Deskripsi ekspresi. Ini adalah teks yang lebih panjang yang menjelaskan ekspresi, misalnya saat diarahkan ke ekspresi tersebut di UI. |
location |
Opsional. String yang menunjukkan lokasi ekspresi untuk pelaporan error, misalnya nama file dan posisi dalam file. |
TimeZone
Merepresentasikan zona waktu dari Database Zona Waktu IANA.
| Kolom | |
|---|---|
id |
Zona waktu Database Zona Waktu IANA, misalnya "America/New_York". |
version |
Opsional. Nomor versi Database Zona Waktu IANA, misalnya "2019a". |