Package google.type

Indeks

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau dianggap tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Kolom
year

int32

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

int32

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

int32

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

Tanggal dan Waktu

Mewakili waktu sipil (atau terkadang waktu fisik).

Jenis ini dapat merepresentasikan waktu sipil dengan salah satu dari beberapa kemungkinan cara:

  • Jika utc_offset disetel dan time_zone tidak disetel: waktu sipil pada hari kalender dengan perbedaan waktu tertentu dari UTC.
  • Jika time_zone disetel dan utc_offset tidak disetel: waktu sipil pada hari kalender dalam zona waktu tertentu.
  • Jika time_zone maupun utc_offset tidak ditetapkan: waktu sipil pada hari kalender dalam waktu setempat.

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. Sebaiknya gunakan 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 beberapa aplikasi. Pastikan untuk mendokumentasikan dan memvalidasi batasan aplikasi Anda.

Kolom
year

int32

Opsional. Tahun dalam hari. Harus dari 1 hingga 9999, atau 0 jika menentukan tanggal dan waktu tanpa tahun.
month

int32

Opsional. Bulan. Harus dari 1 hingga 12, atau 0 jika menentukan tanggal dan waktu tanpa bulan.
day

int32

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

int32

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 waktu tutup bisnis.
minutes

int32

Opsional. Menit dalam jam. Harus antara 0 hingga 59, defaultnya adalah 0.
seconds

int32

Opsional. Detik menit dari waktu. Biasanya harus berkisar antara 0 sampai 59, default-nya adalah 0. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

int32

Opsional. Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999, default-nya adalah 0.
Kolom union time_offset. Opsional. Menentukan offset UTC atau zona waktu DateTime. Pilih salah satu dengan cermat, dengan mempertimbangkan bahwa data zona waktu dapat berubah di masa mendatang (misalnya, suatu negara mengubah tanggal mulai/akhir DST, dan DateTime di masa mendatang dalam rentang yang terpengaruh telah disimpan). Jika tidak diisi, DateTime dianggap dalam waktu lokal. time_offset hanya dapat berupa salah satu dari berikut:
utc_offset

Duration

Selisih waktu UTC. Harus berupa detik penuh, antara -18 jam dan +18 jam. Misalnya, selisih waktu UTC -4:00 akan ditampilkan sebagai { seconds: -14400 }.
time_zone

TimeZone

Zona waktu.

Interval

Menampilkan interval waktu yang dienkode sebagai waktu mulai Stempel Waktu (inklusif) dan waktu berakhir Stempel Waktu (eksklusif).

Waktu mulai harus kurang dari atau sama dengan waktu berakhir. Jika waktu mulai sama dengan waktu berakhir, intervalnya kosong (tidak ada waktu yang cocok). Jika waktu mulai dan waktu berakhir tidak ditentukan, intervalnya akan cocok dengan semua waktu.

Kolom
start_time

Timestamp

Opsional. Waktu mulai interval inklusif.

Jika ditentukan, Stempel Waktu yang cocok dengan interval ini harus sama dengan atau setelah waktu mulai.
end_time

Timestamp

Opsional. Waktu berakhir interval eksklusif.

Jika ditentukan, Stempel Waktu yang cocok dengan interval ini harus sebelum waktu berakhir.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Kolom
latitude

double

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

double

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

LocalizedText

Varian teks yang dilokalkan dalam bahasa tertentu.

Kolom
text

string

String yang dilokalkan dalam bahasa yang sesuai dengan language_code di bawah.
language_code

string

Kode bahasa BCP-47 untuk teks, seperti "en-US" atau "sr-Latn".

Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

TimeZone

Mewakili zona waktu dari Database Zona Waktu IANA.

Kolom
id

string

Zona waktu IANA Time Zone Database. Misalnya, "America/New_York".
version

string

Opsional. Nomor versi Database Zona Waktu IANA. Misalnya, "2019a".