Date
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:
- uma data completa, com valores de ano, mês e dia diferentes de zero;
- um mês e dia, com um ano zero (por exemplo, uma data comemorativa);
- um ano sozinho, com um mês zero e um dia zero;
- um ano e mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).
Tipos relacionados:
| Representação JSON |
{
"year": integer,
"month": integer,
"day": integer
} |
| Campos |
year |
integer
Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
|
month |
integer
Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
|
day |
integer
Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e represents a calendar date (birthday, anniversary) using the Gregorian Calendar, allowing for full dates, month/day, year only, or year/month combinations.\u003c/p\u003e\n"],["\u003cp\u003eIt can be a full date, a month and day, a year, or a year and month.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation is an object with \u003ccode\u003eyear\u003c/code\u003e, \u003ccode\u003emonth\u003c/code\u003e, and \u003ccode\u003eday\u003c/code\u003e integer fields, with 0 values indicating missing components.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e is related to other 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"]]],["This schema defines a calendar date using the Gregorian Calendar, representing full dates or partial dates. Key actions include specifying a `year` (1-9999, or 0), `month` (1-12, or 0), and `day` (1-31, or 0). A zero value in `year`, `month`, or `day` indicates that the field is not relevant. The format represents full dates, month/day pairs, year-only, or year/month combinations. It is related to `TimeOfDay`, `DateTime`, and `Timestamp`.\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://developers.google.com/protocol-buffers/docs/reference/google.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. |"]]
