Package google.type

Dizin

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Ay ve gün, sıfır yıl ile (örneğin, yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Yıl ve ay, sıfır günle (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

Alanlar
year

int32

Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month

int32

Yılın ayı. 1 ile 12 arasında olmalı veya ay ve gün içermeyen bir yıl belirtmek için 0 olmalıdır.
day

int32

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

Tarih ve saat

Günlük zamanı (veya bazen fiziksel zamanı) temsil eder.

Bu tür, olası birkaç şekilde sivil zamanı temsil edebilir:

  • utc_offset ayarlanmış ve time_zone ayarlanmamışsa: Takvim gününde UTC'den belirli bir farka sahip yerel saat.
  • time_zone ayarlanmış ve utc_offset ayarlanmamışsa: Belirli bir saat dilimindeki bir takvim gününde yerel saat.
  • Ne time_zone ne de utc_offset ayarlanmadığında: Yerel saatte takvim günündeki sivil saat.

Tarih, Proleptik Gregoryen Takvimi'ne göre belirlenir.

Yıl, ay veya gün 0 ise DateTime'ın sırasıyla belirli bir yılı, ayı veya günü olmadığı kabul edilir.

Bu tür, tüm tarih ve saat alanları ayarlanmışsa ve time_offset oneof'un her iki durumu da ayarlanmışsa fiziksel bir zamanı temsil etmek için de kullanılabilir. Bunun yerine fiziksel zaman için Timestamp mesajını kullanabilirsiniz. Kullanım alanınızda kullanıcının saat diliminin de depolanması isteniyorsa bu işlem başka bir alanda yapılabilir.

Bu tür, bazı uygulamaların isteyebileceğinden daha esnektir. Uygulamanızın sınırlamalarını belgelediğinizden ve doğruladığınızdan emin olun.

Alanlar
year

int32

İsteğe bağlıdır. Tarihin yılı. 1 ile 9999 arasında olmalıdır. Yıl içermeyen bir tarih ve saat belirtiliyorsa 0 olmalıdır.
month

int32

İsteğe bağlıdır. Yılın ayı. 1 ile 12 arasında olmalıdır. Ay içermeyen bir tarih/saat belirtiliyorsa 0 olmalıdır.
day

int32

İsteğe bağlıdır. Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Gün içermeyen bir tarih/saat belirtiliyorsa 0 olmalıdır.
hours

int32

İsteğe bağlıdır. Günün saatleri (24 saatlik biçimde). 0 ile 23 arasında olmalıdır. Varsayılan değer 0'dır (gece yarısı). Bir API, işletmenin kapanış saati gibi senaryolarda "24:00:00" değerine izin vermeyi seçebilir.
minutes

int32

İsteğe bağlıdır. Günün saatindeki dakikalar. 0 ile 59 arasında olmalıdır, varsayılan değer 0'dır.
seconds

int32

İsteğe bağlıdır. Dakikaların saniyeleri. Normalde 0 ile 59 arasında olmalıdır, varsayılan olarak 0'dır. Bir API, artık saniyelere izin veriyorsa 60 değerine izin verebilir.
nanos

int32

İsteğe bağlıdır. Saniyenin kesirleri nanosaniye cinsinden. 0 ile 999.999.999 arasında olmalıdır. Varsayılan değer 0'dır.
time_offset birleşik alanı. İsteğe bağlıdır. DateTime'ın UTC farkını veya saat dilimini belirtir. Saat dilimi verilerinin gelecekte değişebileceğini (örneğin, bir ülke yaz saati başlangıç/bitiş tarihlerini değiştirir ve etkilenen aralıktaki gelecekteki DateTime'lar zaten depolanmıştır) göz önünde bulundurarak bunlar arasında dikkatli bir seçim yapın. Belirtilmezse DateTime'ın yerel saatte olduğu kabul edilir. time_offset aşağıdakilerden yalnızca biri olabilir:
utc_offset

Duration

UTC farkı. -18 saat ile +18 saat arasında tam saniye olmalıdır. Örneğin, -4:00 UTC farkı { seconds: -14400 } olarak gösterilir.
time_zone

TimeZone

Saat dilimi.

Aralık

Bir zaman aralığını, Başlangıç zaman damgası (dahil) ve Bitiş zaman damgası (hariç) olarak kodlanmış şekilde gösterir.

Başlangıç değeri, bitiş değerinden küçük veya ona eşit olmalıdır. Başlangıç ve bitiş zamanı aynı olduğunda aralık boştur (herhangi bir zamanla eşleşmez). Hem başlangıç hem de bitiş belirtilmediğinde aralık herhangi bir zamana karşılık gelir.

Alanlar
start_time

Timestamp

İsteğe bağlıdır. Aralığın başlangıç zamanı dahildir.

Bu aralıkla eşleşen bir zaman damgası belirtilirse başlangıçla aynı veya başlangıçtan sonra olmalıdır.
end_time

Timestamp

İsteğe bağlıdır. Aralığın bitiş zamanı dahil değildir.

Bu aralıkla eşleşen bir zaman damgası belirtilirse bitişten önce olmalıdır.

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu, enlem derecelerini ve boylam derecelerini temsil etmek için çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

Alanlar
latitude

double

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

double

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.

LocalizedText

Belirli bir dildeki metnin yerelleştirilmiş varyantı.

Alanlar
text

string

Aşağıdaki language_code ile eşleşen dilde yerelleştirilmiş dize.
language_code

string

Metnin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.

TimeZone

IANA Saat Dilimi Veritabanı'ndaki bir saat dilimini temsil eder.

Alanlar
id

string

IANA Saat Dilimi Veritabanı saat dilimi. Örneğin, "America/New_York".
version

string

İsteğe bağlıdır. IANA saat dilimi veritabanı sürüm numarası. Örneğin, "2019a".