DateTime

แสดงเวลาทั่วไป (หรือเวลาจริงในบางครั้ง)

ประเภทนี้แสดงเวลาพลเรือนได้หลายวิธีดังนี้

  • เมื่อตั้งค่า utcOffset และไม่ได้ตั้งค่า timeZone: เวลาพลเรือนในวันตามปฏิทินที่มีค่าชดเชยเวลาจาก UTC ที่เฉพาะเจาะจง
  • เมื่อตั้งค่า 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
ฟิลด์ Union time_offset ไม่บังคับ ระบุการชดเชยเวลา UTC หรือเขตเวลาของ DateTime โปรดเลือกอย่างรอบคอบโดยคำนึงถึงว่าข้อมูลเขตเวลาอาจมีการเปลี่ยนแปลงในอนาคต (เช่น ประเทศหนึ่งๆ แก้ไขวันที่เริ่มต้น/สิ้นสุดของ DST และระบบได้จัดเก็บ DateTime ในอนาคตในช่วงที่ได้รับผลกระทบไว้แล้ว) หากไม่ระบุ ระบบจะถือว่า DateTime เป็นเวลาท้องถิ่น time_offset ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
utcOffset

string (Duration format)

ความต่างเวลา UTC ต้องเป็นวินาทีเต็ม โดยอยู่ระหว่าง -18 ชั่วโมงถึง +18 ชั่วโมง เช่น ออฟเซ็ต UTC ที่ -4:00 จะแสดงเป็น { seconds: -14400 }

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
timeZone

object (TimeZone)

เขตเวลา

TimeZone

แสดงเขตเวลาจากฐานข้อมูลเขตเวลาของ IANA

การแสดง JSON 
{
  "id": string,
  "version": string
}
ช่อง
id

string

เขตเวลาของฐานข้อมูลเขตเวลาของ IANA เช่น "America/New_York"
version

string

ไม่บังคับ หมายเลขเวอร์ชันฐานข้อมูลเขตเวลาของ IANA เช่น "2019a"