Indeks
Tanggal dan Waktu
Mewakili waktu sipil (atau terkadang waktu fisik).
Jenis ini dapat merepresentasikan waktu sipil dengan salah satu dari beberapa cara yang mungkin:
- Jika utc_offset disetel dan time_zone tidak disetel: 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 mewakili 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 dalam hari. 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 dalam bulan. 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 dari 0 hingga 23, setelan defaultnya adalah 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 dapat berupa salah satu dari berikut: |
|
utc_ |
Offset UTC. Harus seluruh detik, antara -18 jam dan +18 jam. Misalnya, offset UTC -4:00 akan direpresentasikan sebagai { seconds: -14400 }. |
time_ |
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 lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis. |
minutes |
Menit dalam jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59. |
seconds |
Detik dalam satu menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika memungkinkan detik kabisat. |
nanos |
Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999. |
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". |