Date
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
表示整个或部分日历日期(例如生日)。一天中的时间和时区要么在别处指定,要么不重要。日期相对于公历。可以表示以下任一情况:
- 包含非零年、月和日值的完整日期
- 月份和日期值,年份值为零,如周年纪念日
- 单独的年份,月份值和日期值为零
- 年份值和月份值,日期为零,例如信用卡失效日期
相关类型为 google.type.TimeOfDay
和 google.protobuf.Timestamp
。
JSON 表示法 |
{
"year": integer,
"month": integer,
"day": integer
} |
字段 |
year |
integer
日期中的年份。必须介于 1 到 9999 之间,或为 0(即指定不含年份的日期)。
|
month |
integer
一年中的第几个月。必须介于 1 到 12 之间,或为 0(即只指定年份,不指定月份和天值)。
|
day |
integer
一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效,或为 0(即天不重要,指定单独的年份或者年份和月份)。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e represents a calendar date, including full dates, month/day combinations, years, or year/month combinations.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes the Gregorian Calendar and can be used for birthdays, anniversaries, and credit card expirations.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation consists of \u003ccode\u003eyear\u003c/code\u003e, \u003ccode\u003emonth\u003c/code\u003e, and \u003ccode\u003eday\u003c/code\u003e integer fields, with 0 values indicating the absence of a specific component.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e is related to \u003ccode\u003egoogle.type.TimeOfDay\u003c/code\u003e and \u003ccode\u003egoogle.protobuf.Timestamp\u003c/code\u003e for representing other temporal aspects.\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 value, with a zero year, such as an anniversary\n- A year on its own, with zero month and day values\n- A year and month value, with a zero day, such as a credit card expiration date\n\nRelated types are [google.type.TimeOfDay](/my-business/reference/rest/v4/accounts.locations.localPosts#TimeOfDay) and `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. |"]]