Index
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes darstellen:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
- Einen Monat und einen Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
- Ein Jahr für sich, mit einem Monat und einem Tag von 0.
- Ein Jahr und ein Monat mit einem Tag von 0, z. B. ein Ablaufdatum der Kreditkarte.
Ähnliche Typen:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Felder | |
|---|---|
year |
Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird. |
month |
Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird. |
day |
Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist. |
Datum/Uhrzeit
Stellt die amtliche Zeit (oder gelegentlich die physische Zeit) dar.
Dieser Typ kann eine amtliche Zeit auf verschiedene Arten darstellen:
- Wenn „utc_offset“ festgelegt und „time_zone“ nicht festgelegt ist: eine amtliche Zeit an einem Kalendertag mit einem bestimmten Versatz zu 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 das DateTime-Objekt kein bestimmtes Jahr, keinen bestimmten Monat bzw. keinen bestimmten Tag hat.
Dieser Typ kann auch verwendet werden, um eine physische Zeit darzustellen, wenn alle Datums- und Zeitfelder festgelegt sind und einer der beiden Fälle von time_offset festgelegt ist. Verwenden Sie stattdessen die Timestamp-Nachricht für die physische Zeit. Wenn es in Ihrem Anwendungsfall wünschenswert ist, die Zeitzone des Nutzers ebenfalls zu speichern, können Sie das in einem anderen Feld tun.
Dieser Typ ist möglicherweise flexibler, als es für einige Anwendungen erwünscht ist. Dokumentieren und validieren Sie die Einschränkungen Ihrer Anwendung.
| Felder | |
|---|---|
year |
Optional. Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum/Uhrzeit-Element ohne Jahresangabe angegeben wird. |
month |
Optional. Monat des Jahres. Er muss zwischen 1 und 12 liegen oder kann 0 sein, wenn ein Datum/Uhrzeit-Element ohne Monat angegeben wird. |
day |
Optional. Tag des Monats. Er muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn ein Datum/Uhrzeit-Element ohne Tag angegeben wird. |
hours |
Optional. Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Der Standardwert ist 0 (Mitternacht). Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen. |
minutes |
Optional. Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen. Der Standardwert ist 0. |
seconds |
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 |
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 des DateTime an. Wählen Sie sorgfältig zwischen ihnen aus, da sich Zeitzonendaten in Zukunft ändern können (beispielsweise wenn ein Land die Start- und Enddaten der Sommerzeit ändert und zukünftige DateTimes im betroffenen Zeitraum bereits gespeichert wurden). Wird die DateTime weggelassen, wird davon ausgegangen, dass sie in der Ortszeit angegeben ist. Für time_offset ist nur einer der folgenden Werte zulässig: |
|
utc_offset |
UTC-Versatz. Muss eine ganze Zahl in Sekunden zwischen –18 Stunden und +18 Stunden sein. Ein UTC-Versatz von –4:00 würde beispielsweise als {seconds: –14400} dargestellt. |
time_zone |
Zeitzone. |
Intervall
Stellt ein Zeitintervall dar, das als Zeitstempelstart (einschließlich) und Zeitstempelende (ausschließlich) codiert ist.
Der Start muss kleiner oder gleich dem Ende sein. Wenn der Start dem Ende entspricht, ist das Intervall leer (die Zeit ist null). Wenn sowohl der Start als auch das Ende nicht angegeben sind, entspricht das Intervall einer beliebigen Zeit.
| Felder | |
|---|---|
start_time |
Optional. Eingeschlossener Start des Intervalls. Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, gleich dem Start sein oder darauf folgen. |
end_time |
Optional. Ausgeschlossenes Ende des Intervalls. Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, vor dem Ende liegen. |
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 |
Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen. |
longitude |
Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen. |
LocalizedText
Lokalisierte Variante eines Texts in einer bestimmten Sprache.
| Felder | |
|---|---|
text |
Lokalisierter String in der Sprache, die |
language_code |
Der BCP-47-Sprachcode des Texts, z. B. „en-US“ oder „sr-Latn“. Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
TimeZone
Stellt eine Zeitzone aus der IANA-Zeitzonendatenbank dar.
| Felder | |
|---|---|
id |
Zeitzone aus der IANA-Zeitzonendatenbank. Beispiel: „America/New_York“. |
version |
Optional. Versionsnummer der IANA-Zeitzonendatenbank. Beispiel: „2019a“. |