Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants:
- Date complète avec des valeurs d'année, de mois et de jour non nulles
- une valeur pour le mois et le jour, avec une année nulle, par exemple un anniversaire ;
- une année seule, avec un mois et un jour nuls ;
- une année et un mois, avec un jour nul, par exemple une date d'expiration de carte de crédit.
Les types associés sont google.type.TimeOfDay
et google.protobuf.Timestamp
.
Représentation JSON | |
---|---|
{ "year": integer, "month": integer, "day": integer } |
Champs | |
---|---|
year |
Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année. |
month |
Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour. |
day |
Jour d'un mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 pour spécifier une année seule, ou une année et un mois où le jour n'est pas significatif. |