Package google.type

Индекс

Дата

Представляет собой полную или частичную календарную дату, например, день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указана относительно григорианского календаря. Может представлять собой одно из следующих событий:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Похожие типы:

Поля
year

int32

Год даты. Должен быть от 1 до 9999 или 0, чтобы указать дату без года.

month

int32

Месяц года. Должен быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

int32

День месяца. Должен быть от 1 до 31 и действителен для года и месяца, или 0, чтобы указать только год или год и месяц, если день не имеет значения.

ДатаВремя

Представляет гражданское время (или иногда физическое время).

Этот тип может представлять гражданское время одним из нескольких возможных способов:

  • Если установлено utc_offset и не установлено time_zone: гражданское время в календарный день с определенным смещением от UTC.
  • Если time_zone установлен, а utc_offset не установлен: гражданское время календарного дня в определенном часовом поясе.
  • Если не установлены ни time_zone, ни utc_offset: гражданское время в календарный день по местному времени.

Дата указана относительно пролептического григорианского календаря.

Если год, месяц или день равны 0, то считается, что DateTime не имеет определенного года, месяца или дня соответственно.

Этот тип также может использоваться для представления физического времени, если заданы все поля даты и времени, а также задан один из вариантов 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. Выбирайте внимательно, учитывая, что данные о часовом поясе могут измениться в будущем (например, страна меняет даты начала/окончания летнего времени, а будущие значения DateTime в соответствующем диапазоне уже сохранены). Если это поле пропущено, DateTime считается местным временем. time_offset может быть только одним из следующих:
utc_offset

Duration

Смещение относительно UTC. Должно быть целыми секундами в диапазоне от -18 до +18 часов. Например, смещение относительно UTC -4:00 будет представлено как {seconds: -14400}.

time_zone

TimeZone

Часовой пояс.

Интервал

Представляет временной интервал, закодированный как начальная метка времени (включительно) и конечная метка времени (исключая).

Начало должно быть меньше или равно концу. Если начало равно концу, интервал пустой (не соответствует ни одному времени). Если ни начало, ни конец не указаны, интервал соответствует любому времени.

Поля
start_time

Timestamp

Необязательно. Начало интервала включено.

Если указано, то соответствующая этому интервалу временная метка должна быть такой же или более поздней.

end_time

Timestamp

Необязательно. Исключительный конец интервала.

Если указано, то соответствующая этому интервалу временная метка должна быть до конца.

Широта и долгота

Объект, представляющий пару широта/долгота. Выражается в виде пары чисел двойной точности, представляющих градусы широты и долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в нормализованных диапазонах.

Поля
latitude

double

Широта в градусах. Должна быть в диапазоне [-90,0, +90,0].

longitude

double

Долгота в градусах. Должна быть в диапазоне [-180,0, +180,0].

Локализованный текст

Локализованный вариант текста на определенном языке.

Поля
text

string

Локализованная строка на языке, соответствующем указанному ниже language_code .

language_code

string

Код языка текста BCP-47, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .

Часовой пояс

Представляет часовой пояс из базы данных часовых поясов IANA .

Поля
id

string

Часовой пояс базы данных часовых поясов IANA. Например, «America/New_York».

version

string

Необязательно. Номер версии базы данных часовых поясов IANA. Например, «2019a».