Package google.type

Index

• Date (message)
• DateTime (message)
• Interval (message)
• LatLng (message)
• LocalizedText (message)
• TimeZone (message)

Date

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:

• A full date, with non-zero year, month, and day values.
• A month and day, with a zero year (for example, an anniversary).
• A year on its own, with a zero month and a zero day.
• A year and month, with a zero day (for example, a credit card expiration date).

Related types:

• google.type.TimeOfDay
• google.type.DateTime
• google.protobuf.Timestamp

Fields
year	int32 Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
month	int32 Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
day	int32 Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

DateTime

Represents civil time (or occasionally physical time).

This type can represent a civil time in one of a few possible ways:

• When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC.
• When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone.
• When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time.

The date is relative to the Proleptic Gregorian Calendar.

If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively.

This type may also be used to represent a physical time if all the date and time fields are set and either case of the time_offset oneof is set. Consider using Timestamp message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field.

This type is more flexible than some applications may want. Make sure to document and validate your application's limitations.

Fields
year	int32 Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
month	int32 Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
day	int32 Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
hours	int32 Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
minutes	int32 Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
seconds	int32 Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
nanos	int32 Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
Union field time_offset. Optional. Specifies either the UTC offset or the time zone of the DateTime. Choose carefully between them, considering that time zone data may change in the future (for example, a country modifies their DST start/end dates, and future DateTimes in the affected range had already been stored). If omitted, the DateTime is considered to be in local time. time_offset can be only one of the following:
utc_offset	Duration UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
time_zone	TimeZone Time zone.

Interval

Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive).

The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.

Fields
start_time	Timestamp Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
end_time	Timestamp Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.

LatLng

An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.

Fields
latitude	double The latitude in degrees. It must be in the range [-90.0, +90.0].
longitude	double The longitude in degrees. It must be in the range [-180.0, +180.0].

LocalizedText

Localized variant of a text in a particular language.

Fields
text	string Localized string in the language corresponding to language_code below.
language_code	string The text's BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

TimeZone

Represents a time zone from the IANA Time Zone Database.

Fields
id	string IANA Time Zone Database time zone. For example "America/New_York".
version	string Optional. IANA Time Zone Database version number. For example "2019a".