Timestamp

การประทับเวลาหมายถึงช่วงเวลาที่ไม่ขึ้นกับเขตเวลาหรือปฏิทินท้องถิ่นใดๆ โดยเข้ารหัสเป็นจำนวนวินาทีและเศษส่วนของวินาทีที่ความละเอียดระดับนาโนวินาที จำนวนนี้จะสัมพันธ์กับ Epoch ในเวลาเที่ยงคืนของวันที่ 1 มกราคม 1970 ตามเวลา UTC ในปฏิทินเกรกอเรียนที่ส่งผลใหม่ ซึ่งขยายปฏิทินเกรกอเรียนย้อนกลับไปถึงปีที่ 1

นาทีทั้งหมดมีความยาว 60 วินาที เสี้ยววินาทีคือ "การละเลง" เพื่อที่จะได้ไม่ต้องอาศัยตารางที่ 2 ในการตีความ โดยใช้ สเมียร์เชิงเส้น 24 ชั่วโมง

โดยอยู่ในช่วงตั้งแต่ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59.999999999Z การจำกัดช่วงดังกล่าวจะทำให้เราสามารถแปลงเป็นและแปลงจากสตริงวันที่ RFC 3339 ได้

การแสดง JSON
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงเป็นวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z รวมด้วย

nanos

integer

เศษส่วนที่ไม่เป็นลบของวินาทีที่ความละเอียดระดับนาโนวินาที ค่าวินาทีติดลบที่มีเศษส่วนยังต้องมีค่านาโนที่ไม่เป็นลบซึ่งจะนับต่อไปตามเวลา ต้องมีค่าตั้งแต่ 0 ถึง 999,999,999