Package google.type

الفهرس

التاريخ

تمثّل هذه السمة تاريخ تقويم كاملاً أو جزئيًا، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

الأنواع ذات الصلة:

الحقول
year

int32

سنة التاريخ يجب أن يكون الرقم بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

int32

الشهر من السنة يجب أن يكون الرقم بين 1 و12، أو 0 لتحديد سنة بدون شهر ويوم.
day

int32

اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وصالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون فيه اليوم مهمًا.

DateTime

تمثّل هذه السمة الوقت المدني (أو الوقت الفعلي أحيانًا).

يمكن أن يمثّل هذا النوع وقتًا مدنيًا بإحدى الطرق القليلة الممكنة:

  • عند ضبط utc_offset وعدم ضبط time_zone: يشير ذلك إلى الوقت المدني في يوم من أيام التقويم مع معادلة معيّنة من التوقيت العالمي المنسّق.
  • عند ضبط time_zone وعدم ضبط utc_offset: يشير ذلك إلى الوقت المدني في يوم تقويمي في منطقة زمنية معيّنة.
  • عندما لا يتم ضبط كل من time_zone وutc_offset: وقت مدني في يوم تقويمي بالتوقيت المحلي.

التاريخ نسبي إلى التقويم الغريغوري الاستباقي.

إذا كانت قيمة السنة أو الشهر أو اليوم هي 0، يعني ذلك أنّ DateTime لا يتضمّن سنة أو شهرًا أو يومًا محدّدًا على التوالي.

يمكن أيضًا استخدام هذا النوع لتمثيل وقت فعلي إذا تم ضبط جميع حقول التاريخ والوقت وتم ضبط أي من الحالتين في time_offset oneof. يمكنك استخدام الرسالة Timestamp بدلاً من ذلك. إذا كانت حالة الاستخدام تتطلّب أيضًا تخزين المنطقة الزمنية للمستخدم، يمكن إجراء ذلك في حقل آخر.

هذا النوع أكثر مرونة مما قد تريده بعض التطبيقات. احرص على توثيق القيود المفروضة على تطبيقك والتحقّق من صحتها.

الحقول
year

int32

اختيارية: سنة التاريخ يجب أن يكون الرقم بين 1 و9999، أو 0 إذا كنت تحدّد تاريخًا ووقتًا بدون سنة.
month

int32

اختيارية: الشهر من السنة. يجب أن يكون الرقم بين 1 و12، أو 0 إذا كنت تحدّد تاريخًا ووقتًا بدون شهر.
day

int32

اختيارية: اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وصالحًا للسنة والشهر، أو 0 إذا كنت تحدّد تاريخًا ووقتًا بدون يوم.
hours

int32

اختيارية: ساعات اليوم بتنسيق 24 ساعة يجب أن تتراوح القيمة بين 0 و23، ويتم ضبطها تلقائيًا على 0 (منتصف الليل). يمكن لواجهة برمجة التطبيقات أن تسمح بالقيمة "24:00:00" في سيناريوهات مثل وقت إغلاق النشاط التجاري.
minutes

int32

اختيارية: دقائق الساعة من اليوم يجب أن تتراوح القيمة بين 0 و59، والقيمة التلقائية هي 0.
seconds

int32

اختيارية: ثواني الدقائق من الوقت يجب أن تتراوح القيمة عادةً بين 0 و59، ويتم ضبطها تلقائيًا على 0. قد يسمح أحد واجهات برمجة التطبيقات بالقيمة 60 إذا كان يسمح بالثواني الكبيسة.
nanos

int32

اختيارية: أجزاء من الثانية بالنانو ثانية يجب أن تتراوح القيمة بين 0 و999,999,999، والقيمة التلقائية هي 0.
حقل الدمج time_offset اختيارية: تحدّد هذه السمة إما معادلة التوقيت العالمي المنسّق أو المنطقة الزمنية للتاريخ والوقت. اختَر بعناية بينهما، مع الأخذ في الاعتبار أنّ بيانات المنطقة الزمنية قد تتغيّر في المستقبل (على سبيل المثال، إذا عدّل بلد ما تواريخ بدء/انتهاء التوقيت الصيفي، وتمّ تخزين قيم DateTime المستقبلية في النطاق المتأثّر). في حال عدم توفّرها، يُفترض أنّ DateTime بالتوقيت المحلي. يمكن أن تكون time_offset إحدى القيم التالية فقط:
utc_offset

Duration

فارق التوقيت عن التوقيت العالمي المتفق عليه يجب أن تكون القيمة عددًا صحيحًا من الثواني، بين -18 ساعة و+18 ساعة. على سبيل المثال، سيتم تمثيل إزاحة التوقيت العالمي المنسق (UTC) بمقدار ‎-4:00 على النحو التالي: { seconds: -14400 }.
time_zone

TimeZone

المنطقة الزمنية

الفاصل الزمني

يمثّل فاصلاً زمنيًا محدّدًا يتم ترميزه بطابع زمني للبداية (مشمولة) وطابع زمني للنهاية (غير مشمولة).

يجب أن تكون البداية مساوية أو أقدم من النهاية. إذا كانت البداية مساوية للنهاية، يكون الفاصل فارغًا (أي لا يطابق أي وقت). وإذا لم يتم تحديد البداية والنهاية، يطابق الفاصل أي وقت.

الحقول
start_time

Timestamp

اختياري. يمثّل بداية الفاصل الزمني (مشمولة).

إذا تم تحديد هذا الحقل، يجب أن يكون أي طابع زمني يطابق هذا الفاصل مساويًا أو لاحقًا لوقت البداية.
end_time

Timestamp

اختيارية: يمثّل نهاية الفاصل الزمني (غير مشمولة).

إذا تم تحديد هذا الحقل، يجب أن يكون أي طابع زمني يطابق هذا الفاصل قبل وقت النهاية.

LatLng

كائن يمثّل زوج خط العرض/خط الطول. يتم التعبير عن ذلك كزوج من الأرقام المضاعفة لتمثيل درجات خط العرض ودرجات خط الطول. ما لم يُذكر خلاف ذلك، يجب أن يتوافق هذا العنصر مع معيار WGS84. يجب أن تكون القيم ضمن النطاقات العادية.

الحقول
latitude

double

تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

double

تمثّل هذه السمة خط الطول بالدرجات. يجب أن تكون القيمة ضمن النطاق [-180.0, +180.0].

LocalizedText

نسخة مترجَمة من نص بلغة معيّنة

الحقول
text

string

سلسلة مترجَمة باللغة المتوافقة مع language_code أدناه
language_code

string

تمثّل هذه السمة رمز اللغة المستخدَمة في النص وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn".

لمزيد من المعلومات، يُرجى الانتقال إلى http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

TimeZone

تمثّل هذه السمة منطقة زمنية من قاعدة بيانات المناطق الزمنية التابعة لهيئة IANA.

الحقول
id

string

المنطقة الزمنية في قاعدة بيانات المناطق الزمنية التابعة لهيئة IANA على سبيل المثال، "America/New_York".
version

string

اختيارية: رقم إصدار قاعدة بيانات المناطق الزمنية التابعة لهيئة IANA على سبيل المثال، "2019a".