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.

DateTime

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

Kolom
year

int32

Opsional. Tahun. 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. Harus dari 1 hingga 31 dan valid 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 ada, DateTime dianggap dalam waktu setempat. time_offset hanya ada berupa salah satu diantara 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.

Expr

Menampilkan ekspresi tekstual dalam sintaksis Common Expression Language (CEL). CEL adalah bahasa ekspresi seperti 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 (Kesamaan):

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 persis yang dapat dirujuk dalam ekspresi ditentukan oleh layanan yang mengevaluasinya. Lihat dokumentasi layanan untuk mengetahui informasi tambahan.

Kolom
expression

string

Representasi tekstual ekspresi dalam sintaksis Common Expression Language.
title

string

Opsional. Judul untuk ekspresi, yaitu string pendek yang menjelaskan tujuannya. Ini dapat digunakan misalnya di UI yang memungkinkan untuk memasukkan ekspresi.
description

string

Opsional. Deskripsi ekspresi. Ini adalah teks yang lebih panjang yang menjelaskan ekspresi, misalnya saat kursor diarahkan ke teks tersebut di UI.
location

string

Opsional. String yang menunjukkan lokasi ekspresi untuk pelaporan error, misalnya nama file dan posisi dalam file.

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".