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 כדי לציין שנה בלבד או שנה וחודש שבהם אין חשיבות לציון יום מסוים.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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. |"]]
