Package google.type

索引

日期

表示完整或部分的日曆日期，例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主，可代表下列其中一項：

  • 完整日期，具有非零的年、月和日值。
  • 月和日，年值為零 (例如週年紀念日)。
  • 只有年，月和日值為零。
  • 年和月，日值為零 (例如信用卡到期日)。

相關類型：

欄位
year

int32

日期年份。必須為 1 到 9999；如要指定不含年份的日期，請輸入 0。
month

int32

一年中的月份。必須為 1 到 12；如要指定不含日期的年份，請輸入 0。
day

int32

當月第幾日。必須為 1 到 31，並屬於有效的年和月；如果只指定年份，或只指定年份和月份，而不指定當月第幾日的話，請輸入 0。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

時間間隔

代表時間間隔，編碼以一個時間戳記開始 (含)，一個時間戳記結束 (不含)。

開始時間必須小於或等於結束時間。如果開始時間等於結束時間，間隔會是空白 (不符合任何時間)。如果開始和結束時間都未指定，則間隔會符合任何時間。

欄位
start_time

Timestamp

選用。間隔的開始時間 (含)。

如果指定了這個值，符合此間隔的時間戳記必須等於或晚於開始時間。
end_time

Timestamp

選用。間隔的結束時間 (不含)。

如果指定，符合這個間隔的時間戳記必須早於結束時間。

金額

表示金額與貨幣類型。

欄位
currency_code

string

ISO 4217 定義的貨幣代碼，由 3 個字母組成。
units

int64

金額的整數單位。舉例來說，如果 currencyCode 為 "USD"，則 1 個單位為 1 美元。
nanos

int32

金額的奈米 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 units 為正值，nanos 必須為正值或零。如果 units 為零，則 nanos 可為正值、零或負值。如果 units 為負值，nanos 就必須為負值或零。例如，$-1.75 美元的表式方式為 units=-1 和 nanos=-750,000,000。

TimeOfDay

代表一天中的時間。日期和時區並不需要指定，或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Date 和 google.protobuf.Timestamp。

欄位
hours

int32

一天中的小時，採用 24 小時制。必須大於或等於 0，且通常必須小於或等於 23。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。
minutes

int32

每小時的第幾分鐘。必須大於或等於 0，且小於或等於 59。
seconds

int32

一分鐘內的秒數。必須大於或等於 0，且通常必須小於或等於 59。如果 API 允許閏秒，則可允許值為 60。
nanos

int32

秒數的小數，以奈秒為單位。必須大於或等於 0，且小於或等於 999,999,999。

TimeZone

代表 IANA 時區資料庫中的時區。

欄位
id

string

IANA 時區資料庫時區。例如「America/New_York」。
version

string

選用。IANA 時區資料庫版本號碼。例如「2019a」。