索引
日期
表示整个或部分日历日期,例如生日。一天中的时间和时区要么在别处指定,要么不重要。该日期相对于公历。它可以表示以下其中一项:
- 包含非零年、月和日值的完整日期。
- 月份和日期,年份为 0(例如周年纪念日)。
- 单独的一年,零月零日。
- 年份和月份,日期为零(例如信用卡失效日期)。
相关类型:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
字段 | |
---|---|
year |
日期中的年份。必须是 1 到 9999 之间的数字,如果使用 0,则可以指定不含年份的日期。 |
month |
一年中的某月。必须是 1 到 12 之间的数字,如果为 0,则表示不包含月份和日期。 |
day |
一个月中的第几天。必须是 1 到 31 之间的数字,并且对年份和月份有效,或者为 0 表示单独指定年份,或者在日期不重要的情况下指定年份和月份。 |
DayOfWeek
表示星期几。
枚举 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
未指定星期几。 |
MONDAY |
星期一 |
TUESDAY |
星期二 |
WEDNESDAY |
星期三 |
THURSDAY |
星期四 |
FRIDAY |
星期五 |
SATURDAY |
星期六 |
SUNDAY |
星期日 |
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 和 999999999 之间的数字。 |