Package google.type

ดัชนี

• DateTime (ข้อความ)
• TimeOfDay (ข้อความ)
• TimeZone (ข้อความ)

DateTime

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

ประเภทนี้สามารถแสดงถึงเวลาพลเรือนด้วยวิธีใดวิธีหนึ่งต่อไปนี้

• เมื่อตั้งค่า utc_offset และไม่มีการตั้งค่า time_zone คือเวลามาตรฐานในวันที่ตามปฏิทินซึ่งมีออฟเซ็ตที่เจาะจงจาก UTC
• เมื่อตั้งค่า time_zone และตั้งค่า utc_offset ไว้: เป็นเวลาทั่วไปของวันตามปฏิทินในเขตเวลาหนึ่งๆ
• เมื่อไม่ได้ตั้งค่า time_zone และ utc_offset ไว้: เป็นเวลาปกติในวันตามปฏิทินตามเวลาท้องถิ่น

ซึ่งเป็นวันที่ที่เกี่ยวข้องกับปฏิทินเกรโกเรียน Proleptic Gregorian

หากปี เดือน หรือวันเป็น 0 ระบบจะถือว่าวันที่และเวลาไม่มีปี เดือน หรือวันที่เฉพาะเจาะจงตามลำดับ

ประเภทนี้อาจใช้เพื่อแสดงเวลาจริงได้หากมีการตั้งค่าช่องวันที่และเวลาไว้ทั้งหมดและตั้งค่ากรณีใดกรณีหนึ่งของการใช้ time_offset อย่างใดอย่างหนึ่ง ลองใช้ข้อความ Timestamp สำหรับเวลาจริงแทน หากกรณีการใช้งานของคุณต้องการจัดเก็บเขตเวลาของผู้ใช้ด้วย คุณสามารถทำได้ในช่องอื่น

ประเภทนี้มีความยืดหยุ่นมากกว่าที่แอปพลิเคชันบางอย่างอาจต้องการ อย่าลืมบันทึกและตรวจสอบข้อจำกัดของใบสมัคร

ช่อง
year	int32 ไม่บังคับ ปีของวันที่ ต้องเป็นตัวเลข 1 ถึง 9999 หรือ 0 หากระบุวันที่และเวลาโดยไม่มีปี
month	int32 ไม่บังคับ เดือนของปี ต้องเป็น 1 ถึง 12 หรือ 0 หากระบุวันที่และเวลาโดยไม่ระบุเดือน
day	int32 ไม่บังคับ วันของเดือน ค่านี้ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรืออาจเป็น 0 หากระบุวันที่และเวลาโดยไม่มีวัน
hours	int32 ไม่บังคับ ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 และมีค่าเริ่มต้นเป็น 0 (เที่ยงคืน) API อาจเลือกอนุญาตให้ใช้ค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ
minutes	int32 ไม่บังคับ นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59 โดยมีค่าเริ่มต้นเป็น 0
seconds	int32 ไม่บังคับ วินาทีของนาทีของเวลา โดยปกติจะต้องอยู่ระหว่าง 0 ถึง 59 โดยมีค่าเริ่มต้นเป็น 0 API อาจอนุญาตค่า 60 หากอนุญาตให้ใช้วินาทีอธิกสุรทิน
nanos	int32 ไม่บังคับ เศษส่วนของวินาทีในนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999 และมีค่าเริ่มต้นเป็น 0
ฟิลด์สหภาพ time_offset ไม่บังคับ ระบุการชดเชย UTC หรือเขตเวลาของ DateTime โปรดเลือกอย่างระมัดระวังเนื่องจากข้อมูลเขตเวลาอาจมีการเปลี่ยนแปลงในอนาคต (เช่น ประเทศแก้ไขวันที่เริ่มต้น/สิ้นสุด DST และระบบได้จัดเก็บวันที่และเวลาในอนาคตของช่วงที่ได้รับผลกระทบไว้แล้ว) หากไม่ระบุ ระบบจะถือว่าวันที่และเวลานั้นเป็นเวลาท้องถิ่น time_offset ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
utc_offset	Duration การชดเชย UTC ต้องเป็นจำนวนเต็มวินาที ตั้งแต่ -18 ชั่วโมงถึง +18 ชั่วโมง ตัวอย่างเช่น ออฟเซ็ต UTC ที่ -4:00 จะแสดงเป็น { seconds: -14400 }
time_zone	TimeZone เขตเวลา

TimeOfDay

แสดงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสำคัญหรือระบุไว้ในที่อื่น API อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องได้แก่ google.type.Date และ google.protobuf.Timestamp

ช่อง
hours	int32 ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกอนุญาตให้ใช้ค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ
minutes	int32 นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59
seconds	int32 วินาทีของนาทีของเวลา ปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตค่า 60 หากอนุญาตให้ใช้วินาทีอธิกสุรทิน
nanos	int32 เศษส่วนของวินาทีในนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999

TimeZone

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

ช่อง
id	string เขตเวลาของ IANA Time Zone Database เช่น "America/New_York"
version	string ไม่บังคับ หมายเลขเวอร์ชันของฐานข้อมูลเขตเวลาของ IANA เช่น "2019a"