يمثل تاريخًا تقويميًا كاملاً أو جزئيًا، مثل تاريخ ميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو ليست مهمة. ويكون التاريخ مرتبطًا بالتقويم الميلادي. ويمكن أن يمثّل ذلك أيًا مما يلي:
- تاريخ كامل، لا يتضمن أي قيم صفرية للسنة والشهر واليوم
- قيمة شهر ويوم، بدون عام، كذكرى سنوية
- يُرجى ملاحظة أنّ السنة عامٌ بحد ذاته، بدون قيم شهرية ويومية
- قيمة العام والشهر، بدون يوم، مثل تاريخ انتهاء صلاحية بطاقة الائتمان
النوعان ذوا الصلة هما 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 لتحديد سنة بمفردها أو عام وشهر لا يمثل اليوم 39 نقطة فيه. |