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).
Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
month
int32
Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
day
int32
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-27 UTC."],[[["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e represents a calendar date, supporting full dates, month/day, year only, or year/month combinations.\u003c/p\u003e\n"],["\u003cp\u003eIt uses the Gregorian Calendar and can represent dates with or without specific year, month, and day values.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e has three integer fields: \u003ccode\u003eyear\u003c/code\u003e, \u003ccode\u003emonth\u003c/code\u003e, and \u003ccode\u003eday\u003c/code\u003e, with specific value ranges and 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 different time and date representations.\u003c/p\u003e\n"]]],[],null,["# Package google.type\n\nIndex\n-----\n\n- [Date](/maps/documentation/aerial-view/reference/rpc/google.type#google.type.Date) (message)\n\nDate\n----\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| Fields ||\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `year` | `int32` Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |\n| `month` | `int32` Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |\n| `day` | `int32` 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. |"]]
