الفهرس
التاريخ
يمثّل تاريخًا تقويميًا كاملاً أو جزئيًا، مثل تاريخ ميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يشير ذلك إلى أحد الخيارات التالية:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم
- الشهر واليوم، مع سنة صفرية (مثلاً، ذكرى سنوية)
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر، مع يوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان)
الأنواع ذات الصلة:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| الحقول | |
|---|---|
year |
السنة التي حدث فيها التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
الشهر من السنة يجب أن يكون من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر يجب أن يكون من 1 إلى 31 وصالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يُحتسَب فيها اليوم. |
DayOfWeek
يمثّل يومًا من أيام الأسبوع.
| عمليات التعداد | |
|---|---|
DAY_OF_WEEK_UNSPECIFIED |
لم يتم تحديد اليوم من الأسبوع. |
MONDAY |
الاثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
LatLng
عنصر يمثّل زوجًا من خطوط العرض/خطوط الطول ويتم التعبير عن ذلك في صورة زوج من الزوجات لتمثيل درجات الطول والعرض والدرجات. يجب أن يكون هذا العنصر متوافقًا مع معيار WGS84 ما لم يتم تحديد خلاف ذلك. يجب أن تكون القيم ضمن النطاقات العادية.
| الحقول | |
|---|---|
latitude |
خط العرض بالدرجات يجب أن يكون ضمن النطاق [-90.0, +90.0]. |
longitude |
خط الطول بالدرجات يجب أن يكون في النطاق [ -180.0، +180.0]. |
المال
يمثّل مبلغًا من المال بنوع العملة.
| الحقول | |
|---|---|
currency_ |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217. |
units |
الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة |
nanos |
عدد وحدات النانو (10^-9) للمبلغ يجب أن تتراوح القيمة بين -999,999,999 و+999,999,999. إذا كانت |
TimeOfDay
تمثل وقتًا من اليوم. إما أن التاريخ والمنطقة الزمنية ليست مهمة أو تم تحديدها في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالثواني. الأنواع ذات الصلة هي google.type.Date وgoogle.protobuf.Timestamp.
| الحقول | |
|---|---|
hours |
ساعات اليوم بتنسيق 24 ساعة. يجب أن تكون أكبر من أو تساوي 0 ويجب أن تكون عادةً أقل من أو تساوي 23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق العمل. |
minutes |
دقائق الساعة يجب أن تكون أكبر من أو تساوي 0 وأقل من أو تساوي 59. |
seconds |
ثَانِيَة مِنَ الدَّقِيقَة يجب أن تكون أكبر من أو تساوي 0 ويجب أن تكون عادةً أقل من أو تساوي 59. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة. |
nanos |
الكسور من الثواني، بالنانو ثانية يجب أن تكون أكبر من أو تساوي 0 وأقل من أو تساوي 999,999,999. |