แสดงเวลาพลเมือง (หรือเวลาจริง)
ประเภทนี้อาจแสดงเวลาพลเมืองด้วยวิธีใดวิธีหนึ่งต่อไปนี้
- เมื่อตั้งค่า utcOFFset และไม่ได้ตั้งค่าเขตเวลาไว้: เวลาของวันในวันที่ปฏิทินจะมีการชดเชยเวลาใดเวลาหนึ่งจาก UTC
- เมื่อตั้งค่า timeZone แล้ว และไม่ได้ตั้งค่า utcOFFset: เวลาจริงของวันตามปฏิทินในเขตเวลาที่เจาะจง
- เมื่อไม่มีการตั้งค่า timeZone หรือ utcOFFset: เวลาพลเมืองในวันตามปฏิทินตามเวลาท้องถิ่น
วันที่นี้สัมพันธ์กับปฏิทินเกรกโพรเกรส
หากปี เดือน หรือวันเป็น 0 ระบบจะถือว่าวันที่ไม่มีปี เดือน หรือวันตามลําดับ
ระบบอาจใช้ประเภทนี้เป็นการแสดงเวลาจริงด้วยหากมีการตั้งค่าวันที่และเวลาทั้งหมด รวมถึงตั้งค่าช่องใดช่องหนึ่งจาก time_offset
อย่างใดอย่างหนึ่ง ลองใช้ข้อความ Timestamp
สําหรับเวลาจริงแทน หากกรณีการใช้งานของคุณต้องการเก็บเขตเวลาของผู้ใช้ กรณีนี้จะทําได้ในช่องอื่น
การใช้งานประเภทนี้มีความยืดหยุ่นมากกว่าบางแอป อย่าลืมจัดทําเอกสารและตรวจสอบข้อจํากัดของแอปพลิเคชัน
การแสดง JSON |
---|
{ "year": integer, "month": integer, "day": integer, "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer, // Union field |
ช่อง | |
---|---|
year |
ไม่บังคับ ปีของวันที่ ต้องมีค่าตั้งแต่ 1 ถึง 9999 หรือ 0 หากระบุวันที่และเวลาโดยไม่มีปี |
month |
ไม่บังคับ เดือนของปี ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 หากระบุวันที่และเวลาโดยไม่มีเดือน |
day |
ไม่บังคับ วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 หากระบุวันที่และเวลาโดยไม่มีวัน |
hours |
ไม่บังคับ ช่วงเวลาของวันในรูปแบบ 24 ชั่วโมง ควรเท่ากับ 0 ถึง 23 มีค่าเริ่มต้นเป็น 0 (เที่ยงคืน) API อาจเลือกอนุญาตให้ใช้ค่า "24:00:00" สําหรับสถานการณ์ต่างๆ เช่น เวลาปิดทําการของธุรกิจ |
minutes |
ไม่บังคับ นาทีในชั่วโมงของวัน ต้องมีค่าตั้งแต่ 0 ถึง 59 และมีค่าเริ่มต้นเป็น 0 |
seconds |
ไม่บังคับ จํานวนวินาทีของเวลา ปกติต้องอยู่ระหว่าง 0 ถึง 59 มีค่าเริ่มต้นเป็น 0 API อาจอนุญาตให้ใช้ค่า 60 หากอนุญาตให้ใช้แบบก้าวกระโดด |
nanos |
ไม่บังคับ เศษของวินาทีในหน่วยนาโนวินาที ต้องเป็น 0 ถึง 999,999,999 มีค่าเริ่มต้นเป็น 0 |
ช่อง Union time_offset ไม่บังคับ ระบุการชดเชยเวลา UTC หรือเขตเวลาของ DateTime โปรดเลือกตัวเลขอย่างระมัดระวัง เนื่องจากเมื่อพิจารณาถึงข้อมูลเขตเวลาอาจมีการเปลี่ยนแปลงในอนาคต (เช่น ประเทศใดแก้ไขวันที่เริ่ม/สิ้นสุด DST และระบบได้จัดเก็บวันที่และเวลาในอนาคตในช่วงที่ได้รับผลกระทบแล้ว) หากไม่ระบุ ระบบจะถือว่าวันที่และเวลานั้นเป็นเวลาท้องถิ่น time_offset ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้ |
|
utcOffset |
การชดเชยเวลา UTC ต้องเป็นวินาทีตั้งแต่ -18 ชั่วโมงถึง +18 ชั่วโมง ตัวอย่างเช่น ค่าชดเชย UTC ที่มีค่าเป็น -4:00 จะแสดงเป็น { seconds: -14400 } ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก และลงท้ายด้วย " |
timeZone |
เขตเวลา |
TimeZone
แสดงเขตเวลาจากฐานข้อมูลเขตเวลาของ IANA
การแสดง JSON |
---|
{ "id": string, "version": string } |
ช่อง | |
---|---|
id |
เขตเวลาของฐานข้อมูลเขตเวลาของ IANA เช่น "อเมริกา/นิว_ยอร์ก" |
version |
ไม่บังคับ หมายเลขเวอร์ชันฐานข้อมูลเขตเวลา IANA เช่น "2019a" |