מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. המצב הזה יכול לייצג אחת מהאפשרויות הבאות:
- תאריך מלא, עם ערכים שונים של שנה, חודש ויום
- הערך של חודש ויום, עם אפס שנה, למשל יום נישואין
- שנה בפני עצמה, ללא ערכים של חודש ויום
- ערך של שנה וחודש, עם יום אפס, כמו תאריך תפוגה של כרטיס אשראי
הסוגים הקשורים הם google.type.TimeOfDay ו-google.protobuf.Timestamp.
| ייצוג JSON | |
|---|---|
{ "year": integer, "month": integer, "day": integer } |
|
| שדות | |
|---|---|
year |
השנה שבה חל התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה. |
month |
החודש בשנה. הערך חייב להיות 1 עד 12, או 0 כדי לציין שנה בלי חודש ויום. |
day |
היום בחודש. הערך צריך להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם אין חשיבות לציון יום מסוים. |