Indeks
DateTime
Menggambarkan waktu sipil (atau terkadang waktu fisik).
Jenis ini dapat mewakili waktu sipil dengan salah satu dari beberapa cara yang memungkinkan:
- 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 dalam zona waktu tertentu.
- Jika time_zone atau utc_offset tidak ditetapkan: waktu sipil pada hari kalender dalam waktu lokal.
Tanggal ini relatif terhadap Kalender Gregorian Proleptik.
Jika tahun, bulan, atau hari adalah 0, DateTime dianggap tidak memiliki tahun, bulan, atau hari tertentu masing-masing.
Jenis ini juga dapat digunakan untuk mewakili waktu fisik jika semua kolom tanggal dan waktu ditetapkan dan salah satu kasus dari time_offset
ditetapkan. Pertimbangkan untuk menggunakan pesan Timestamp
untuk waktu fisik. Jika kasus penggunaan Anda juga ingin menyimpan zona waktu pengguna, Anda dapat melakukannya di kolom lain.
Jenis ini lebih fleksibel daripada yang mungkin diinginkan beberapa aplikasi. Pastikan untuk mendokumentasikan dan memvalidasi batasan aplikasi Anda.
Kolom | |
---|---|
year |
Opsional. Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 jika menentukan tanggal dan waktu tanpa tahun. |
month |
Opsional. Bulan. Harus dari 1 hingga 12, atau 0 jika menentukan tanggal dan waktu tanpa bulan. |
day |
Opsional. Hari dalam bulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 jika menentukan tanggal dan waktu tanpa hari. |
hours |
Opsional. Jam dalam format 24 jam. Harus dari 0 hingga 23, defaultnya adalah 0 (tengah malam). API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis. |
minutes |
Opsional. Menit dalam jam. Harus dari 0 sampai 59, defaultnya adalah 0. |
seconds |
Opsional. Detik dari menit. Biasanya harus antara 0 hingga 59, defaultnya harus 0. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik. |
nanos |
Opsional. Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999, defaultnya adalah 0. |
Kolom union time_offset . Opsional. Menentukan offset UTC atau zona waktu DateTime. Pilih dengan hati-hati di antara keduanya, dengan mempertimbangkan bahwa data zona waktu dapat berubah di masa mendatang (misalnya, suatu negara mengubah tanggal mulai/berakhir DST, dan DateTime di masa mendatang dalam rentang yang terpengaruh telah disimpan). Jika dihilangkan, DateTime dianggap dalam waktu lokal. time_offset hanya ada berupa salah satu diantara berikut: |
|
utc_offset |
Offset UTC. Harus berupa seluruh detik, antara -18 jam hingga +18 jam. Misalnya, offset UTC sebesar -4:00 akan direpresentasikan sebagai { detik: -14400 }. |
time_zone |
Zona waktu. |
TimeOfDay
Merepresentasikan waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk mengizinkan detik kabisat. Jenis terkait adalah google.type.Date
dan google.protobuf.Timestamp
.
Kolom | |
---|---|
hours |
Jam dalam format 24 jam. Harus antara 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis. |
minutes |
Menit dalam jam. Harus antara 0 hingga 59. |
seconds |
Detik dari menit. Biasanya harus antara 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik. |
nanos |
Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999. |
TimeZone
Mewakili 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". |