DateTime
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Представляет гражданское время (или иногда физическое время).
Этот тип может представлять гражданское время одним из нескольких возможных способов:
- Если установлен utcOffset, а timeZone не установлен: гражданское время в календарный день с определенным смещением от UTC.
- Если timeZone установлен, а utcOffset не установлен: гражданское время в календарный день в определенном часовом поясе.
- Если ни timeZone, ни utcOffset не установлены: гражданское время в календарный день по местному времени.
Дата указана по пролептическому григорианскому календарю.
Если год, месяц или день равны 0, считается, что DateTime не имеет определенного года, месяца или дня соответственно.
Этот тип также можно использовать для представления физического времени, если установлены все поля даты и времени и установлен любой случай одного из time_offset . Вместо этого рассмотрите возможность использования сообщения Timestamp для физического времени. Если в вашем варианте использования также требуется сохранить часовой пояс пользователя, это можно сделать в другом поле.
Этот тип более гибок, чем может потребоваться некоторым приложениям. Обязательно задокументируйте и подтвердите ограничения вашего приложения.
| JSON-представление |
|---|
{
"year": integer,
"month": integer,
"day": integer,
"hours": integer,
"minutes": integer,
"seconds": integer,
"nanos": integer,
// Union field time_offset can be only one of the following:
"utcOffset": string,
"timeZone": {
object (TimeZone)
}
// End of list of possible types for union field time_offset.
} |
| Поля |
|---|
year | integer Необязательный. Год даты. Должно быть от 1 до 9999 или 0, если указать дату и время без года. |
month | integer Необязательный. Месяц года. Должно быть от 1 до 12 или 0, если указывается дата и время без месяца. |
day | integer Необязательный. День месяца. Должно быть от 1 до 31 и действительно для года и месяца, или 0, если указано время и дата без дня. |
hours | integer Необязательный. Часы суток в 24-часовом формате. Должно быть от 0 до 23, по умолчанию — 0 (полночь). API может разрешить использование значения «24:00:00» для таких сценариев, как время закрытия предприятия. |
minutes | integer Необязательный. Минуты часа дня. Должно быть от 0 до 59, по умолчанию — 0. |
seconds | integer Необязательный. Секунды минут времени. Обычно должно быть от 0 до 59, по умолчанию — 0. API может допускать значение 60, если он допускает дополнительные секунды. |
nanos | integer Необязательный. Доли секунды в наносекундах. Должно быть от 0 до 999 999 999, по умолчанию — 0. |
Поле объединения time_offset . Необязательный. Указывает либо смещение UTC, либо часовой пояс DateTime. Выбирайте между ними осторожно, учитывая, что данные часового пояса могут измениться в будущем (например, страна изменяет даты начала и окончания летнего времени, а будущие значения DateTime в затронутом диапазоне уже сохранены). Если этот параметр опущен, считается, что DateTime соответствует местному времени. time_offset может быть только одним из следующих: |
utc Offset | string ( Duration format) Смещение UTC. Должны быть целые секунды в диапазоне от -18 часов до +18 часов. Например, смещение UTC -4:00 будет представлено как {секунды: -14400}. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
time Zone | object ( TimeZone ) Часовой пояс. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[],[],null,["# DateTime\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nRepresents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n- When utcOffset is set and timeZone is unset: a civil time on a calendar day with a particular offset from UTC.\n- When timeZone is set and utcOffset is unset: a civil time on a calendar day in a particular time zone.\n- When neither timeZone nor utcOffset is set: a civil time on a calendar day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively.\n\nThis 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.\n\nThis type is more flexible than some applications may want. Make sure to document and validate your application's limitations.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"year\": integer, \"month\": integer, \"day\": integer, \"hours\": integer, \"minutes\": integer, \"seconds\": integer, \"nanos\": integer, // Union field `time_offset` can be only one of the following: \"utcOffset\": string, \"timeZone\": { object (/maps/documentation/weather/reference/rest/v1/TimeZone) } // End of list of possible types for union field `time_offset`. } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `year` | `integer` Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year. |\n| `month` | `integer` Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month. |\n| `day` | `integer` 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. |\n| `hours` | `integer` 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. |\n| `minutes` | `integer` Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0. |\n| `seconds` | `integer` 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. |\n| `nanos` | `integer` Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0. |\n| 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: ||\n| `utc``Offset` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` 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 }. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `time``Zone` | `object (`[TimeZone](/maps/documentation/weather/reference/rest/v1/TimeZone)`)` Time zone. |"]]
