Représente une date du calendrier complète ou partielle, comme un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ils ne sont pas significatifs. La date est liée au 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
- Valeur d'un mois et d'un jour, avec une année nulle, comme un anniversaire
- une année seule, avec un mois et un jour nuls ;
- Une année et un mois, avec un jour nul, comme 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. La valeur doit être comprise entre 1 et 9 999, ou égale à 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 indiquer une année sans mois ni jour. |
day |
Jour du mois. La valeur doit être comprise entre 1 et 31, et valide pour l'année et le mois, ou égale à 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif. |