Page Summary
-
google.type.Daterepresents a calendar date, including full dates, month/day combinations, years, or year/month combinations. -
It utilizes the Gregorian Calendar and can be used for birthdays, anniversaries, and credit card expirations.
-
The JSON representation consists of
year,month, anddayinteger fields, with 0 values indicating the absence of a specific component. -
google.type.Dateis related togoogle.type.TimeOfDayandgoogle.protobuf.Timestampfor representing other temporal aspects.
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 value, with a zero year, such as an anniversary
- A year on its own, with zero month and day values
- A year and month value, with a zero day, such as a credit card expiration date
Related types are google.type.TimeOfDay
and google.protobuf.Timestamp
.
| JSON representation | |
|---|---|
{ "year" : integer , "month" : integer , "day" : integer } |
|
| Fields | |
|---|---|
year
|
Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |
month
|
Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
day
|
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. |

