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