Date
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
表示完整或部分的日曆日期,例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主,這可以代表下列其中一項:
- 完整日期,具有非零的年、月和日值。
- 月和日,年值為零 (例如週年紀念日)。
- 只有年,月和日值為零。
- 年和月,日值為零 (例如信用卡到期日)。
相關類型:
JSON 表示法 |
{
"year": integer,
"month": integer,
"day": integer
} |
欄位 |
year |
integer
日期中的年份。必須為 1 到 9999;如要指定不含年份的日期,請輸入 0。
|
month |
integer
一年中的月份。必須為 1 到 12;如要指定不含日期的年份,請輸入 0。
|
day |
integer
當月第幾日。必須為 1 到 31,並屬於有效的年和月;如果只指定年份,或只指定年份和月份,而不指定當月第幾日的話,請輸入 0。
|
保留所有權利。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\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 dates.\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 representation.\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, 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. |"]]