Package google.type

אינדקס

תאריך

מייצג תאריך מלא או חלקי ביומן, כמו יום הולדת. השעה ביום ואזור הזמן צוינו במקום אחר או שהם לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. הערך הזה יכול לייצג את אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שאינם אפס לשנה, לחודש וליום.
  • חודש ויום, עם שנה אפסית (לדוגמה, יום נישואין).
  • שנה לבד, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך התפוגה של כרטיס אשראי).

סוגים קשורים:

שדות
year

int32

השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

int32

החודש בשנה. הערך צריך להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

int32

היום בחודש. הערך חייב להיות בין 1 ל-31, והוא צריך להיות תקף לשנה ולחודש, או 0 כדי לציין רק שנה או שנה וחודש שבהם היום לא משמעותי.

DateTime

מייצג זמן אזרחי (או לעיתים זמן פיזי).

הסוג הזה יכול לייצג זמן אזרחי באחת מכמה דרכים אפשריות:

  • אם מוגדר utc_offset ולא מוגדר time_zone: שעה אזרחית ביום בלוח השנה עם קיזוז מסוים מ-UTC.
  • אם הערך של time_zone מוגדר והערך של utc_offset לא מוגדר: שעה אזרחית ביום מסוים ביומן, באזור זמן מסוים.
  • אם לא מוגדרים time_zone או utc_offset: שעה אזרחית ביום ביומן בשעה המקומית.

התאריך הוא יחסי ליומן הגרגוריאני הפרוֹלֶפטי.

אם השנה, החודש או היום הם 0, התאריך והשעה נחשבים כחסרי שנה, חודש או יום ספציפיים, בהתאמה.

אפשר להשתמש בסוג הזה גם כדי לייצג זמן פיזי אם כל שדות התאריך והשעה מוגדרים ואחד מהמקרים של 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 (חצות). יכול להיות ש-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 או את אזור הזמן של התאריך והשעה. חשוב לבחור בקפידה בין האפשרויות האלה, כי יכול להיות שנתוני אזור הזמן ישתנו בעתיד (לדוגמה, מדינה משנה את תאריכי ההתחלה והסיום של שעון הקיץ, ותאריכי שעה ותאריך עתידיים בטווח המושפע כבר נשמרו). אם לא מציינים את אזור הזמן, המערכת מניחה שהתאריך והשעה הם לפי הזמן המקומי. הערך time_offset יכול להיות רק אחד מהבאים:
utc_offset

Duration

הפרש משעון UTC. הערך צריך להיות מספר שלם של שניות, בין ‎-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'.