DateTime

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

這個類型可透過以下幾種方式表示公元時間：

  • 當 utcOffset 已設定且 timeZone 未設定時：日曆日期的民用時間，與世界標準時間有特定偏移。
  • 當 timeZone 已設定，但 utcOffset 未設定時：特定時區中日曆日期的民用時間。
  • 如果未設定 timeZone 或 utcOffset：以當地時間表示的曆法日民用時間。

日期以西曆為主。

如果年、月或日為 0，系統會認為 DateTime 分別沒有特定年、月或日。

如果已設定所有日期和時間欄位，且已設定 time_offset oneof 的任一情況，則也可使用此類型來表示實際時間。建議您改用 Timestamp 訊息來表示實際時間。如果您的用途也想儲存使用者的時區，可以使用其他欄位。

這類型比某些應用程式所需的彈性更高。請務必記錄並驗證應用程式的限制。

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
欄位
year

integer

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

integer

選用設定。月份。必須為 1 到 12；如要指定不含月份的日期時間，請輸入 0。
day

integer

選用設定。當月第幾日。必須為 1 到 31，並屬於有效的年和月；如果只指定日期時間，請輸入 0。
hours

integer

選用設定。一天中的小時，採用 24 小時制。值應介於 0 到 23 之間，預設值為 0 (午夜)。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。
minutes

integer

選用設定。一天中，每小時內的分鐘。值必須介於 0 到 59 之間，預設值為 0。
seconds

integer

選用設定。在當下時間中，該分鐘的秒數。值必須介於 0 到 59 之間，預設為 0。如果 API 允許閏秒，則可允許值為 60。
nanos

integer

選用設定。秒數的小數，以奈秒為單位。值必須介於 0 到 999,999,999 之間，預設值為 0。
聯集欄位 time_offset。選用設定。指定 DateTime 的 UTC 偏移或時區。請謹慎選擇，因為時區資料日後可能會變更 (例如，某個國家/地區修改夏令時間開始/結束日期，而受影響範圍內的未來日期/時間已儲存)。如果省略，系統會將 DateTime 視為當地時間。time_offset 只能是下列其中一項：
utcOffset

string (Duration format)

世界標準時間時差。必須是整數秒，介於 -18 小時和 +18 小時之間。舉例來說，如果 UTC 偏移值為 -4:00，則會以 { seconds: -14400 } 表示。

以秒為單位的時間長度，最多可有 9 個小數位數，結尾為「s」，例如："3.5s"。
timeZone

object (TimeZone)

時區。