Timestamp

时间戳表示与任何时区或本地日历无关的时间点,以纳秒精度的秒数和秒数的小数部分进行编码。该计数相对于 1970 年 1 月 1 日零点的公元纪年(在公历中,该公历将公历向前延至第 1 年)中相应的纪元。

所有分钟的时长均为 60 秒。闰秒经过“均匀处理”因此,解读时无需闰秒表,使用 24 小时线性均匀分布

范围从 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59.999999999Z。通过限定在该范围之内,可以确保能够在 RFC 3339 日期字符串之间来回转换。

JSON 表示法
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示从 Unix epoch (1970-01-01T00:00:00Z) 起算的秒数,采用世界协调时间 (UTC)。必须介于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z 之间(含边界值)。

nanos

integer

秒的非负分数(纳秒精度)。对于含小数部分的负秒数,仍必须包含按时间递升的非负纳秒值。必须介于 0 到 999,999,999 之间(含边界值)。