DateTime

JSON 表示法
{
  "date": string
}
欄位
date

string

採用 ISO 8601 擴充格式的日期/時間。不一定要使用偏移 (請參閱父項欄位的說明文件)。時間的精確度可以指定到奈秒。偏移量可以指定秒精確度 (雖然偏移秒數並非 ISO 8601 的一部分)。

例如:

1985-04-12T23:20:50.52Z 是世界標準時間 1985 年 4 月 12 日 23 時 20 分 50.52 秒。

1985-04-12T19:20:50.52-04:00 是 1985 年 4 月 12 日 19 時 20 分 50.52 秒,比世界標準時間慢 4 個小時 (與上述範例為同一時間)。如果日期/時間是用於紐約的某個實際位置,則等同於美東夏令時間 (EDT)。請注意,偏移量可能會因當地時段而異。

1985-04-12T19:20:50.52 是 1985 年 4 月 12 日 19 時 20 分 50.52 秒,不含偏移資訊。

如果提供偏移,這個欄位就會成為世界各國的絕對時間。系統會根據使用者的時區調整日期/時間。舉例來說,2018-06-19T18:30:00-04:00 對紐約的使用者而言是 18:30:00,對洛杉磯的使用者來說則是 15:30:00。

如果省略時差,這個欄位就會顯示當地日期/時間,代表世界各個時間的多個瞬時時間。日期/時間一律會以使用者目前的時區為準。舉例來說,2018-06-19T18:30:00 對紐約的使用者而言是 18:30:00,而對洛杉磯的使用者來說也是 18:30:00。如果有多個實體地點橫跨不同時區,而相同的當地日期/時間就必須套用相同的當地日期/時間,這項功能就非常實用。