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 (חצות). אתם יכולים להשתמש ב-API כדי לאשר את הערך '24:00:00' בתרחישים כמו שעת הסגירה של העסק.
minutes

int32

זה שינוי אופציונלי. דקות בשעה ביום. חייב להיות בין 0 ל-59, וברירת המחדל היא 0.
seconds

int32

זה שינוי אופציונלי. שניות של זמן. הערך חייב להיות מספר בין 0 ל-59, וברירת המחדל היא 0. ה-API עשוי לאפשר את הערך 60 אם הוא מאפשר שניות מדלגות.
nanos

int32

זה שינוי אופציונלי. שברי שניות בננו-שניות. חייב להיות בין 0 ל-999,999,999, וברירת המחדל היא 0.
שדה איחוד time_offset. זה שינוי אופציונלי. מציין את הפרש השעות לעומת UTC או את אזור הזמן של DateTime. חשוב לבחור ביניהם בקפידה, כי נתוני אזור הזמן עשויים להשתנות בעתיד (לדוגמה, מדינה משנה את תאריכי ההתחלה והסיום של שעון קיץ, ו-DateTimes עתידיים בטווח המושפע כבר אוחסנו). אם לא מציינים את הפרמטר הזה, הערך של DateTime נחשב לשעון המקומי. 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 Time Zone Database, למשל "America/New_York".
version

string

זה שינוי אופציונלי. מספר הגרסה של IANA Time Zone Database, למשל: "2019a".