Дата и время


Чтение даты и времени

Zenky.io хранит все даты в часовом поясе UTC. Перед выдачей эти даты конвертируются в структуру DateTime:

Поле datetime_utc хранит в себе то же самое значение, что и в наших базах. Значения полей timezone, datetime, datetime_at и diff могут отличаться в зависимости от следующих условий:

  1. Если запрос API выполняется из-под аутентифицированного пользователя, используется часовой пояс, сохранённый в его профиле;
  2. Если передан HTTP-заголовок X-Timezone, используется указанный часовой пояс (может переопределять часовой пояс пользователя);
  3. Если пользовательский часовой пояс не указан, используется часовой пояс по умолчанию (Москва, UTC+3).

Указанные выше поля будут скорректированы относительно часового пояса, определённого по правилам выше.

Запись даты и времени

Если в каких-то методах API от вас требуется предоставить дату и время, считайте, что значение должно передаваться в часовом поясе UTC (если не указано иное).

Исключением является поле deliver_at в методе отправки заказа — оно должно нести значение в часовом поясе города, где оформляется заказ.