Package google.type

Indeks

Data

Reprezentuje pełną lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z zerowym rokiem (np. rocznica).
  • Sam rok, z miesiącem i dniem o wartości zero.
  • Rok i miesiąc z dniem zerowym (np. data ważności karty kredytowej).

Powiązane typy:

Pola
year

int32

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku.
month

int32

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia.
day

int32

Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok albo rok i miesiąc, w których dzień nie ma znaczenia.

DateTime

Reprezentuje czas urzędowy (lub czasami czas fizyczny).

Ten typ może reprezentować czas urzędowy na kilka możliwych sposobów:

  • Gdy parametr utc_offset jest ustawiony, a parametr time_zone nie jest ustawiony: czas urzędowy w dniu kalendarzowym z określonym przesunięciem względem czasu UTC.
  • Gdy ustawiona jest wartość time_zone, a wartość utc_offset nie jest ustawiona: czas urzędowy w dniu kalendarzowym w określonej strefie czasowej.
  • Jeśli nie ustawiono ani time_zone, ani utc_offset: czas urzędowy w dniu kalendarzowym w czasie lokalnym.

Data jest podana w kalendarzu gregoriańskim.

Jeśli rok, miesiąc lub dzień mają wartość 0, DateTime nie ma odpowiednio określonego roku, miesiąca ani dnia.

Ten typ może też służyć do reprezentowania czasu fizycznego, jeśli wszystkie pola daty i godziny są ustawione i ustawiony jest jeden z przypadków time_offset. Zamiast tego możesz użyć wiadomości Timestamp w przypadku czasu fizycznego. Jeśli w Twoim przypadku użycia chcesz też przechowywać strefę czasową użytkownika, możesz to zrobić w innym polu.

Ten typ jest bardziej elastyczny, niż niektóre aplikacje mogą sobie życzyć. Pamiętaj, aby udokumentować i zweryfikować ograniczenia aplikacji.

Pola
year

int32

Opcjonalne. Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę i godzinę bez roku.
month

int32

Opcjonalne. Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz datę i godzinę bez miesiąca.
day

int32

Opcjonalne. Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz datę i godzinę bez dnia.
hours

int32

Opcjonalne. Godziny w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23, a domyślnie wynosi 0 (północ). Interfejs API może zezwalać na wartość „24:00:00” w przypadku takich scenariuszy jak godzina zamknięcia firmy.
minutes

int32

Opcjonalne. Minuty w godzinie dnia. Wartość musi mieścić się w zakresie od 0 do 59, domyślnie jest to 0.
seconds

int32

Opcjonalne. Sekundy w minutach danej godziny. Zwykle musi mieścić się w zakresie od 0 do 59, domyślnie 0. Interfejs API może zezwalać na wartość 60, jeśli dopuszcza sekundy przestępne.
nanos

int32

Opcjonalne. Ułamki sekund w nanosekundach. Wartość musi mieścić się w zakresie od 0 do 999 999 999, domyślnie przyjmuje wartość 0.
Pole zbiorcze time_offset. Opcjonalne. Określa przesunięcie względem czasu UTC lub strefę czasową wartości DateTime. Dokonaj starannego wyboru, pamiętając, że dane strefy czasowej mogą się w przyszłości zmienić (np. kraj może zmodyfikować daty rozpoczęcia i zakończenia czasu letniego, a przyszłe wartości DateTime w zakresie, którego dotyczy zmiana, zostały już zapisane). Jeśli zostanie pominięta, zakłada się, że data i godzina są podane w czasie lokalnym. time_offset może mieć tylko jedną z tych wartości:
utc_offset

Duration

Przesunięcie względem UTC. Musi być liczbą całkowitą sekund z zakresu od –18 godzin do +18 godzin. Na przykład przesunięcie UTC wynoszące –4:00 będzie przedstawione jako { seconds: -14400 }.
time_zone

TimeZone

Strefa czasowa.

Interwał

Reprezentuje przedział czasu zakodowany jako sygnatura czasowa rozpoczęcia (włącznie) i sygnatura czasowa zakończenia (wyłącznie).

Wartość początkowa musi być mniejsza lub równa wartości końcowej. Gdy czas rozpoczęcia jest równy czasowi zakończenia, przedział czasu jest pusty (nie pasuje do żadnego czasu). Jeśli nie podasz ani początku, ani końca, przedział będzie pasować do dowolnego czasu.

Pola
start_time

Timestamp

Opcjonalne. Początek przedziału (włącznie).

Jeśli została określona, sygnatura czasowa pasująca do tego przedziału musi być taka sama jak data rozpoczęcia lub późniejsza.
end_time

Timestamp

Opcjonalnie: Koniec przedziału (wyłącznie).

Jeśli jest określona, sygnatura czasowa pasująca do tego przedziału musi być wcześniejsza niż czas zakończenia.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para liczb zmiennoprzecinkowych podwójnej precyzji, które reprezentują stopnie szerokości i długości geograficznej. O ile nie określono inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.

Pola
latitude

double

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

double

Długość geograficzna w stopniach. Musi mieścić się w zakresie [–180,0, +180,0].

LocalizedText

Zlokalizowana wersja tekstu w określonym języku.

Pola
text

string

Zlokalizowany ciąg tekstowy w języku odpowiadającym wartości language_code poniżej.
language_code

string

Kod języka tekstu w formacie BCP-47, np. „en-US” lub „sr-Latn”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

TimeZone

Reprezentuje strefę czasową z bazy danych stref czasowych IANA.

Pola
id

string

Strefa czasowa z bazy danych stref czasowych IANA. Na przykład „America/New_York”.
version

string

Opcjonalne. Numer wersji bazy danych stref czasowych IANA. Na przykład „2019a”.