Package google.type

索引

DateTime

代表民用時間 (或偶爾實際時間)。

此型別能以幾種可能方式表示民用時間：

  • 設定 utc_offset 且 time_zone 未設定時：日曆日期中的民用時間，且與世界標準時間有特定偏移值。
  • 設定 time_zone 且未設定 utc_offset 時：特定時區在日曆日期中的民用時間。
  • 如果未指定 time_zone 或 utc_offset：一個日曆日期以當地時間為準的民間時間。

日期以{0}公曆為主。

如果年、月或日為 0，則 DateTime 會視為不分別特定年、月或日。

如果設定了所有日期和時間欄位，且已設定 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。選用設定。指定世界標準時間偏移量或 DateTime 時區。請謹慎選擇時區，因為時區資料日後可能會改變 (例如：國家/地區修改了 DST 的開始/結束日期，以及受影響時間範圍內的未來日期時間)。如果省略，DateTime 會視為當地時間。time_offset 只能是下列其中一項：
utc_offset

Duration

世界標準時間偏移。必須為整數，介於 -18 小時至 +18 小時之間。舉例來說，世界標準時間偏移 -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」。