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