TimeOfDay

  • A TimeOfDay representation specifies time without including the date or time zone.

  • The TimeOfDay representation is a JSON object with fields for hours, minutes, seconds, and nanoseconds.

  • The hours field represents the hour in 24-hour format, from 0 to 23, with 24:00:00 potentially allowed.

  • The minutes and seconds fields represent minutes and seconds from 0 to 59, with 60 seconds allowed for leap seconds.

  • The nanos field represents fractions of seconds in nanoseconds, from 0 to 999,999,999.

Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and google.protobuf.Timestamp.

JSON representation
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Fields
hours

integer

Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.

minutes

integer

Minutes of hour of day. Must be from 0 to 59.

seconds

integer

Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.

nanos

integer

Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.