Date
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Lịch Gregory. Thông tin này có thể là một trong những trường hợp sau:
- Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
- Tháng và ngày, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
- Một năm riêng biệt, tháng không tháng và ngày không tháng.
- Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).
Các loại có liên quan:
Biểu diễn dưới dạng JSON |
{
"year": integer,
"month": integer,
"day": integer
} |
Trường |
year |
integer
Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
|
month |
integer
Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.
|
day |
integer
Ngày trong tháng. Phải có giá trị từ 1 đến 31 và có giá trị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-21 UTC."],[[["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e represents a calendar date (birthday, anniversary) using the Gregorian Calendar, allowing for full dates, month/day, year only, or year/month combinations.\u003c/p\u003e\n"],["\u003cp\u003eIt can be a full date, a month and day, a year, or a year and month.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation is an object with \u003ccode\u003eyear\u003c/code\u003e, \u003ccode\u003emonth\u003c/code\u003e, and \u003ccode\u003eday\u003c/code\u003e integer fields, with 0 values indicating missing components.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egoogle.type.Date\u003c/code\u003e is related to other types like \u003ccode\u003egoogle.type.TimeOfDay\u003c/code\u003e, \u003ccode\u003egoogle.type.DateTime\u003c/code\u003e, and \u003ccode\u003egoogle.protobuf.Timestamp\u003c/code\u003e.\u003c/p\u003e\n"]]],["This schema defines a calendar date using the Gregorian Calendar, representing full dates or partial dates. Key actions include specifying a `year` (1-9999, or 0), `month` (1-12, or 0), and `day` (1-31, or 0). A zero value in `year`, `month`, or `day` indicates that the field is not relevant. The format represents full dates, month/day pairs, year-only, or year/month combinations. It is related to `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://developers.google.com/protocol-buffers/docs/reference/google.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. |"]]