Timestamp

時間戳記代表與任何時區或當地行事曆無關的時間點,編碼為以秒為單位的時間戳記,並以秒為單位 (以奈秒為單位完成解析度)。該計數是相對於 1970 年 1 月 1 日午夜 UTC 時序所得的結果,該日曆會把公曆延期延伸至第 1 年。

所有分鐘數皆為 60 秒。閏秒為「smeared」因此,使用 24 小時線性平方時,不需要跳躍第二個表格來進行解讀。

範圍自 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59.99999999Z。透過限制在該範圍,我們可確保能夠轉換為 RFC 3339 日期字串或從該字串轉換。

JSON 表示法
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起,世界標準時間的秒數。必須介於 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z (含) 之間。

nanos

integer

每秒非負數的分數 (以奈秒為單位)。含分數的負第二個值仍須有隨著時間推移的非負數 nanos 值。必須介於 0 至 999,999,999 (含) 之間。