Date
Stay organized with collections
Save and categorize content based on your preferences.
Represents 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:
- A full date, with non-zero year, month, and day values.
- A month and day, with a zero year (for example, an anniversary).
- A year on its own, with a zero month and a zero day.
- A year and month, with a zero day (for example, a credit card expiration date).
Related types:
| JSON representation |
{
"year": integer,
"month": integer,
"day": integer
} |
| Fields |
year |
integer
Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
|
month |
integer
Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
|
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-22 UTC.
[null,null,["Last updated 2024-08-22 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 denote a full date, a month and day, a year only, or a year and month, allowing flexibility in date representation.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON structure includes \u003ccode\u003eyear\u003c/code\u003e, \u003ccode\u003emonth\u003c/code\u003e, and \u003ccode\u003eday\u003c/code\u003e fields with specific integer value constraints for valid date representation.\u003c/p\u003e\n"],["\u003cp\u003eRelated types include \u003ccode\u003egoogle.type.TimeOfDay\u003c/code\u003e, \u003ccode\u003egoogle.type.DateTime\u003c/code\u003e, and \u003ccode\u003egoogle.protobuf.Timestamp\u003c/code\u003e for comprehensive time and date handling.\u003c/p\u003e\n"]]],["The content defines a calendar date representation, relative to the Gregorian Calendar, encompassing full dates, month-day combinations, standalone years, and year-month combinations. Dates are represented as JSON objects with `year`, `month`, and `day` integer fields. `Year` ranges from 1-9999 or 0; `month` from 1-12 or 0; and `day` from 1-31 or 0. Zero values signify unspecified components. Related types include `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://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. |"]]
