Package google.type

الفهرس

DateTime

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

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

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

يرتبط التاريخ بالتقويم الميلادي الصحيح.

وإذا كانت قيمة السنة أو الشهر أو اليوم 0، لا يتم اعتبار التاريخ والوقت ليس له سنة أو شهر أو يوم معيّن على التوالي.

يمكن استخدام هذا النوع أيضًا لتمثيل وقت فعلي في حال ضبط جميع حقلَي التاريخ والوقت وتم ضبط إحدى حالتَي time_offset. يمكنك استخدام رسالة واحدة (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. اختياريّ. تحدّد إما معادلة التوقيت العالمي المنسق (UTC) أو المنطقة الزمنية للتاريخ والوقت. اختَر بينهما بعناية، مع الأخذ في الاعتبار أنّ بيانات المنطقة الزمنية قد تتغيّر في المستقبل (على سبيل المثال، يعدِّل أحد البلدان تواريخ البدء/الانتهاء لتوقيت DST، في حين أنّه سبق أن تم تخزين التواريخ الزمنية المستقبلية في النطاق المتأثرة). وإذا تم حذفها، يتم اعتبار التاريخ والوقت بالتوقيت المحلي. يمكن أن يكون time_offset واحدًا فقط مما يلي:
utc_offset

Duration

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

TimeZone

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

LatLng

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

الحقول
latitude

double

خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0].
longitude

double

خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0].

TimeZone

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

الحقول
id

string

المنطقة الزمنية لقاعدة بيانات المنطقة الزمنية الصادرة عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثل "America/New_York".
version

string

اختياريّ. رقم إصدار قاعدة بيانات المنطقة الزمنية الصادر عن IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثلاً "2019a".