מייצג תאריך קלנדרי שלם או חלקי, כגון תאריך לידה. השעה ביום ואזור הזמן מצוינים במקום אחר או שהם חסרי חשיבות. התאריך הוא יחסי ליומן הגרגוריאני. זה יכול לייצג אחד מהדברים הבאים:
- תאריך מלא, עם ערכים שאינם שנה, חודש ויום
- ערך של חודש ויום, עם שנה של אפס, למשל יום שנה
- שנה כשלעצמה, ללא ערכים של חודש ויום
- ערך של שנה וחודש, עם תאריך אפס, כגון תאריך תפוגה של כרטיס אשראי
הסוגים הקשורים הם 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 כדי לציין שנה עצמה או שנה וחודש שבהם היום לא משמעותי. |