Dizin
DateTime
Medeni zamanı (veya bazen fiziksel zamanı) temsil eder.
Bu tür, medeni bir zamanı temsil etmenin birkaç olası yolu vardır:
- utc_offset ayarlandığında ve saat_bölgesi ayarlanmadan bırakıldığında, bir takvim gününde UTC ile belirli bir uzaklığa sahip günlük saat.
- Saat_ dilimi ayarlandığında ve utc_offset ayarlanmadan bırakıldığında, belirli bir saat dilimindeki bir takvim gününde günlük saattir.
- time_zone veya utc_offset ayarlanmadığında: Yerel saatteki bir takvim gününde günlük bir saat.
Tarih, Proleptik Miladi Takvime göredir.
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ının ayarlanması ve time_offset için bir ayarın ayarlanması durumunda fiziksel bir zamanı göstermek için de kullanılabilir. Bunun yerine fiziksel zaman için Timestamp mesajı kullanabilirsiniz. Kullanım alanınız kullanıcının saat dilimini de kaydetmek istiyorsa bu işlem başka bir alanda yapılabilir.
Bu tür, bazı uygulamaların isteyebileceğinden daha esnektir. Başvurunuzun sınırlarını belgeleyip doğruladığınızdan emin olun.
| Alanlar | |
|---|---|
year |
İsteğe bağlı. Tarih yılı. 1 ile 9999 arasında olmalıdır. Yıl olmadan bir tarih ve saat belirtiyorsanız 0 değeri girilmelidir. |
month |
İsteğe bağlı. Yılın ayı. 1 ile 12 arasında olmalıdır. Ay içermeyen bir tarih ve saat belirtiliyorsa 0 değeri girilmelidir. |
day |
İsteğe bağlı. Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Tarih, gün içermeyen bir tarih ve saat belirtiyorsa bu değer 0 olmalıdır. |
hours |
İsteğe bağlı. 24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır; varsayılan olarak 0 (gece yarısı) değerine ayarlanır. API, işletmenin kapanış saati gibi senaryolarda "24:00:00" değerine izin vermeyi seçebilir. |
minutes |
İsteğe bağlı. Günün saatindeki dakikalar. 0 ile 59 arasında olmalıdır. Varsayılan değer 0'dır. |
seconds |
İsteğe bağlı. Saniye cinsinden dakika. Normalde 0 ile 59 arasında olmalıdır; varsayılan değer 0'dır. Bir API, artık saniyeye izin veriyorsa 60 değerine izin verebilir. |
nanos |
İsteğe bağlı. Nanosaniye cinsinden saniyenin kesirleri. 0 ile 999.999.999 arasında bir değer olmalıdır. Varsayılan değer 0'dır. |
Birleştirme alanı time_offset. İsteğe bağlı. UTC farkını veya DateTime'ın saat dilimini belirtir. Saat dilimi verilerinin gelecekte değişebileceğini (örneğin, bir ülkenin YS başlangıç/bitiş tarihlerini değiştirmesi ve etkilenen aralıktaki gelecekteki DateTime'ların zaten saklanmış olması) göz önünde bulundurularak bunlar arasında dikkatlice seçim yapın. Atlanırsa, DateTime öğesinin yerel saatte olduğu kabul edilir. time_offset şunlardan yalnızca biri olabilir: |
|
utc_offset |
UTC farkı. Tam saniye olmalıdır, -18 saat ile +18 saat arasında olmalıdır. Örneğin, -4:00'lık bir UTC saat farkı, { seconds: -14400 } olarak temsil edilir. |
time_zone |
Saat dilimi. |
LatLng
Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.
| Alanlar | |
|---|---|
latitude |
Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır. |
longitude |
Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır. |
TimeZone
IANA Saat Dilimi Veritabanı'ndan bir saat dilimini temsil eder.
| Alanlar | |
|---|---|
id |
IANA Saat Dilimi Veritabanı saat dilimi, ör. "America/New_York". |
version |
İsteğe bağlı. IANA Saat Dilimi Veritabanı sürüm numarası, ör. "2019a". |