Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum wird relativ zum gregorianischen Kalender angegeben. Dies kann Folgendes darstellen:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
- Monats- und Tageswert mit einem Jahr von 0, z. B. ein Jahrestag
- Ein Jahr für sich, mit Werten von 0 für Monat und Tag
- Einen Wert für Jahr und Monat mit einem Tag 0, z. B. ein Ablaufdatum der Kreditkarte
Vergleichbare Typen sind google.type.TimeOfDay und google.protobuf.Timestamp.
| JSON-Darstellung | |
|---|---|
{ "year": integer, "month": integer, "day": integer } |
|
| 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 im Monat. 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. |