索引
DateTime
表示民用时间（有时也表示实际时间）。
此类型可以通过以下某种可能的方式表示民用时间：
- 如果设置了 utc_offset 且未设置 time_zone：日历日的民用时间，与世界协调时间 (UTC) 有特定偏差。
- 如果设置了 time_zone 且未设置 utc_offset：特定时区中某个日历日的民用时间。
- 如果未设置 time_zone 和 utc_offset：则为日历日的民用时间（本地时间）。
日期相对于前公历。
如果年份、月份或日期为 0，则 DateTime 会被视为分别不具有特定的年份、月份或日期。
如果所有日期和时间字段均已设置，并且 time_offset oneof 的任一情况均已设置，则此类型还可用于表示实际时间。请考虑改用 Timestamp 消息来表示实际时间。如果您的用例还需要存储用户的时区，则可以在其他字段中执行此操作。
此类型的灵活性可能超出了某些应用的需求。请务必记录并验证应用的限制。
| 字段 | |
|---|---|
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 允许闰秒，则 API 可以允许 60 一值。 |
nanos |
可选。秒数的小数部分（以纳秒为单位）。必须介于 0 到 999,999,999 之间，默认为 0。 |
联合字段 time_offset。可选。指定 UTC 偏移量或 DateTime 的时区。请谨慎选择这两者，因为时区数据未来可能会发生变化（例如，某个国家/地区修改了夏令时开始/结束日期，而受影响范围内的未来日期时间已存储）。如果省略，则 DateTime 会被视为当地时间。time_offset 只能是下列其中一项： |
|
utc_ |
UTC 时差。必须是整秒数，介于 -18 小时到 +18 小时之间。例如，世界协调时间 (UTC) 偏移量 -4:00 表示为 { seconds: -14400 }。 |
time_ |
时区。 |
TimeOfDay
表示一天中的某个时间。日期和时区不重要，或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Date 和 google.protobuf.Timestamp。
| 字段 | |
|---|---|
hours |
一天中的时段（采用 24 小时制）。必须大于或等于 0，通常必须小于或等于 23。对于业务结束时间等场景，API 可以选择允许“24:00:00”一值。 |
minutes |
一小时中的分钟数。必须大于或等于 0，小于或等于 59。 |
seconds |
一分钟中的秒数。必须大于或等于 0，通常必须小于或等于 59。如果 API 允许闰秒，则 API 可以允许 60 一值。 |
nanos |
秒数的小数部分（以纳秒为单位）。必须大于或等于 0 且小于或等于 999,999,999。 |
TimeZone
表示 IANA 时区数据库中的时区。
| 字段 | |
|---|---|
id |
IANA 时区数据库中的时区，例如“America/New_York”。 |
version |
可选。IANA 时区数据库版本号，例如“2019a”。 |