Package google.type

Index

DateTime

Steht für die amtliche Zeit (oder gelegentlich in physischer Zeit).

Dieser Typ kann eine amtliche Zeit auf eine von mehreren möglichen Arten darstellen:

  • Wenn „utc_offset“ festgelegt und die Zeitzone nicht festgelegt ist: eine amtliche Zeit an einem Kalendertag mit einem bestimmten Offset von UTC.
  • Wenn „time_zone“ festgelegt und „utc_offset“ nicht festgelegt ist: eine amtliche Zeit an einem Kalendertag in einer bestimmten Zeitzone.
  • Wenn weder time_zone noch utc_offset festgelegt ist: eine amtliche Zeit an einem Kalendertag in Ortszeit.

Das Datum wird relativ zum proleptischen gregorianischen Kalender angegeben.

Wenn Jahr, Monat oder Tag 0 sind, wird davon ausgegangen, dass DateTime kein bestimmtes Jahr, Monat oder Tag hat.

Dieser Typ kann auch für die Darstellung einer physischen Uhrzeit verwendet werden, wenn alle Datums- und Uhrzeitfelder festgelegt sind und entweder die Groß-/Kleinschreibung des time_offset-oneof festgelegt ist. Du kannst die Nachricht „Timestamp“ stattdessen für physische Termine verwenden. Wenn in Ihrem Anwendungsfall auch die Zeitzone des Nutzers gespeichert werden soll, ist dies in einem anderen Feld möglich.

Dieser Typ ist flexibler, als manche Anwendungen es möchten. Dokumentieren und validieren Sie die Einschränkungen Ihrer Anwendung.

Felder
year

int32

Optional. Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, wenn Datum und Uhrzeit ohne Jahr angegeben werden.
month

int32

Optional. Monat des Jahres. Muss zwischen 1 und 12 liegen oder 0 sein, wenn Datum und Uhrzeit ohne Monat angegeben werden.
day

int32

Optional. Tag des Monats. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, wenn ein Datum und eine Uhrzeit ohne Tag angegeben werden.
hours

int32

Optional. Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen, wird standardmäßig 0 (Mitternacht) verwendet. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

int32

Optional. Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen. Der Standardwert ist 0.
seconds

int32

Optional. Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Der Standardwert ist 0. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

int32

Optional. Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen. Der Standardwert ist 0.
Union-Feld time_offset. Optional. Gibt entweder den UTC-Versatz oder die Zeitzone von DateTime an. Treffen Sie die Auswahl sorgfältig, da sich die Zeitzonendaten in Zukunft ändern können (z. B. ändert ein Land das Start- und Enddatum der Sommerzeit und künftige DateTimes im betroffenen Zeitraum wurden bereits gespeichert). Wenn keine Angabe gemacht wird, gilt für „DateTime“ die Ortszeit. Für time_offset ist nur einer der folgenden Werte zulässig:
utc_offset

Duration

UTC-Versatz. Muss ganze Sekunden sein und muss zwischen -18 und +18 Stunden liegen. Eine UTC-Abweichung von -4:00 wird beispielsweise als { seconds: -14400 } dargestellt.
time_zone

TimeZone

Zeitzone

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

Felder
latitude

double

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

double

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

TimeZone

Stellt eine Zeitzone aus der IANA-Zeitzonendatenbank dar.

Felder
id

string

Zeitzone aus der IANA-Zeitzonendatenbank, z. B. "Amerika/New_York".
version

string

Optional. Versionsnummer der IANA-Zeitzonendatenbank, z. B. "2019a".