Date
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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:
- Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
- Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
- une année seule, avec un mois et un jour zéro.
- Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).
Types associés:
| Représentation JSON |
{
"year": integer,
"month": integer,
"day": integer
} |
| Champs |
year |
integer
Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.
|
month |
integer
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 |
integer
Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e represents a calendar date (birthday, anniversary) using JSON format, relative to the Gregorian Calendar.\u003c/p\u003e\n"],["\u003cp\u003eIt can represent a full date, a month and day, a year only, or a year and month, allowing flexibility in date specification.\u003c/p\u003e\n"],["\u003cp\u003eThe date is represented by \u003ccode\u003eyear\u003c/code\u003e, \u003ccode\u003emonth\u003c/code\u003e, and \u003ccode\u003eday\u003c/code\u003e fields in JSON, with 0 values used to indicate unspecified components.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e is related to other time-related types like \u003ccode\u003egoogle.type.TimeOfDay\u003c/code\u003e, \u003ccode\u003egoogle.type.DateTime\u003c/code\u003e, and \u003ccode\u003egoogle.protobuf.Timestamp\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Date\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nRepresents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:\n\n- A full date, with non-zero year, month, and day values.\n- A month and day, with a zero year (for example, an anniversary).\n- A year on its own, with a zero month and a zero day.\n- A year and month, with a zero day (for example, a credit card expiration date).\n\nRelated types:\n\n- `google.type.TimeOfDay`\n- `google.type.DateTime`\n- [google.protobuf.Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)\n\n| JSON representation |\n|---------------------------------------------------------------|\n| ``` { \"year\": integer, \"month\": integer, \"day\": integer } ``` |\n\n| Fields ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `year` | `integer` Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |\n| `month` | `integer` Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |\n| `day` | `integer` Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. |"]]
