Дата и время
Чтение даты и времени
Zenky.io хранит все даты в часовом поясе UTC. Перед выдачей эти даты конвертируются в структуру
DateTime
:
Поле datetime_utc
хранит в себе то же самое значение, что и в наших базах. Значения полей
timezone
, datetime
, datetime_at
и diff
могут отличаться в зависимости от следующих условий:
- Если запрос API выполняется из-под аутентифицированного пользователя, используется часовой пояс, сохранённый в его профиле;
- Если передан HTTP-заголовок
X-Timezone
, используется указанный часовой пояс (может переопределять часовой пояс пользователя); - Если пользовательский часовой пояс не указан, используется часовой пояс по умолчанию (Москва, UTC+3).
Указанные выше поля будут скорректированы относительно часового пояса, определённого по правилам выше.
Запись даты и времени
Если в каких-то методах API от вас требуется предоставить дату и время, считайте, что значение должно передаваться в часовом поясе UTC (если не указано иное).
Исключением является поле deliver_at
в методе
отправки заказа —
оно должно нести значение в часовом поясе города, где оформляется заказ.