Package google.type

Index

Datum/Uhrzeit

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

Dieser Typ kann eine bürgerliche Zeit auf verschiedene Arten darstellen:

  • Wenn „utc_offset“ festgelegt und „time_zone“ nicht festgelegt ist: Eine amtliche Zeit an einem Kalendertag mit einer bestimmten Abweichung von UTC.
  • Wenn „time_zone“ festgelegt und „utc_offset“ nicht festgelegt ist: Eine amtliche Zeitangabe 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 ist, hat das DateTime-Objekt kein bestimmtes Jahr, keinen bestimmten Monat oder keinen bestimmten Tag.

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 Sie in Ihrem Anwendungsfall auch die Zeitzone des Nutzers speichern möchten, können Sie dies in einem anderen Feld tun.

Dieser Typ ist flexibler als für einige Anwendungen erforderlich. Dokumentieren und validieren Sie die Einschränkungen Ihrer Anwendung.

Felder
year

int32

Optional. Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum und eine Uhrzeit ohne Jahresangabe angegeben werden.
month

int32

Optional. Monat des Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Datum und eine Uhrzeit ohne Monat angegeben werden.
day

int32

Optional. 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 ein Datum und eine Uhrzeit ohne Tag angegeben werden.
hours

int32

Optional. Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Standardmäßig ist 0 (Mitternacht) festgelegt. 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. Standardmäßig ist 0 festgelegt.
seconds

int32

Optional. Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Standardmäßig ist 0 festgelegt. 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. Standardmäßig ist 0 festgelegt.
Union-Feld time_offset. Optional. Gibt entweder den UTC-Zeitunterschied oder die Zeitzone der DateTime an. Wählen Sie eine Zeitzone mit Bedacht aus, da sich die Zeitzonendaten in Zukunft ändern können. Beispiel: Ein Land ändert die Start- und Enddaten der Sommerzeit und zukünftige Datumsangaben 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

Zeitzonendifferenz zur UTC Muss eine ganze Zahl zwischen -18 Stunden und +18 Stunden sein. Ein UTC-Offset von -4:00 würde beispielsweise als { seconds: -14400 } dargestellt.
time_zone

TimeZone

Zeitzone

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

Felder
hours

int32

Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

int32

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

int32

Sekunden einer Minute. Muss größer oder gleich 0 und normalerweise kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

int32

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

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".