Документация

Зачем нужны часовые пояса

PingZen работает круглосуточно — и инциденты ваших сервисов тоже. Без явной метки часового пояса временная метка 14:30 неоднозначна: это ваше местное 14:30, серверное или UTC? Неправильное прочтение сдвигает понимание статус-страницы на часы.

Каждая метка времени PingZen хранится в UTC и рендерится в выбранном вами часовом поясе с однозначной подписью.

Три часовых пояса в PingZen

Ваш личный часовой пояс

Селектор Часовой пояс в боковой панели (под пунктом «Язык») задаёт ваш предпочитаемый IANA-пояс — например Europe/Moscow, Asia/Yekaterinburg, America/Los_Angeles.

Это влияет на каждую метку времени, которую вы видите внутри PingZen:

• «Начало» / «Окончание» инцидента
• «Начало» / «Окончание» окна обслуживания
• «Последнее срабатывание» в истории алертов
• Метки последней проверки на мониторах
• Метки последнего пинга на heartbeat-мониторах
• Группировка по датам в списке инцидентов («сегодня» / «вчера» / «последние 7 дней» считается относительно вашего календаря, а не полуночи UTC)
• Вывод MCP-инструментов (см. Часовой пояс в MCP ниже)

Автоопределение при первом входе

При первом входе PingZen читает часовой пояс браузера через Intl.DateTimeFormat().resolvedOptions().timeZone и записывает его в ваш аккаунт. Если он совпадает с вашим реальным местоположением — менять ничего не нужно.

Переключение позже

Путешествия, VPN или редкий случай неверного определения браузером — откройте боковую панель и выберите из подобранного списка ~40 поясов или используйте одноклик-ссылку Использовать часовой пояс браузера (X) которая появляется когда ваш сохранённый пояс отличается от того, что показывает браузер прямо сейчас.

Часовой пояс статус-страницы

У каждой публичной статус-страницы свой параметр Часовой пояс отображения в редакторе страницы (после Темы, перед Мониторами).

В режиме закрепления подвал страницы всегда показывает активный пояс:

Время указано в Europe/Moscow (MSK)

Индикатор намеренно виден на каждой публичной статус-странице — посетитель никогда не должен гадать, означает ли 14:30 его местное 14:30 или серверное.

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

Ответы инструментов MCP-сервера PingZen (используется Claude в Cursor, Claude Code, Cline и других LLM-редакторах) рендерят даты в часовом поясе авторизованного пользователя. Для пользователя с timezone = Europe/Moscow инструмент list_incidents показывает:

! **Database connection timeout** (ID: 12)
   Status: ongoing
   Severity: critical
   Monitor: 47
   Started: 2026-05-12 14:32:05 MSK (+03:00)

Сравните с той же строкой для UTC-пользователя:

   Started: 2026-05-12 11:32:05 UTC (+00:00)

И аббревиатура (MSK, UTC), и числовое смещение (+03:00, +00:00) включены в каждую метку времени — у LLM однозначный контекст, независимо от того, в Москве или Екатеринбурге работает агент.

Инструменты, ставшие tz-aware в 0.16.0

REST API

Управление часовыми поясами через REST.

Примеры

Установить личный часовой пояс:

curl -X PATCH https://pingzen.dev/api/v1/auth/me/timezone \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"timezone": "Europe/Moscow"}'

Закрепить статус-страницу на московское время:

curl -X PUT https://pingzen.dev/api/v1/status-pages/42 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"timezone": "Europe/Moscow"}'

Переключить страницу обратно в режим Авто (часовой пояс посетителя):

curl -X PUT https://pingzen.dev/api/v1/status-pages/42 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"timezone": null}'

Валидация

Сервер проверяет каждый часовой пояс по официальной базе IANA (zoneinfo.available_timezones() на бэкенде). Неизвестные имена отклоняются с HTTP 422 Unprocessable Entity и явным телом ошибки:

{
  "detail": [
    {
      "type": "value_error",
      "loc": ["body", "timezone"],
      "msg": "Value error, Unknown IANA timezone: 'Mars/Olympus'. Use names like 'Europe/Moscow' or 'UTC'."
    }
  ]
}

Бэкенд также пишет WARNING rejected invalid IANA timezone='Mars/Olympus' на каждое отклонение — операторы видят плохих клиентов в audit-логе.

Что остаётся в UTC (и почему)

Некоторые поверхности намеренно игнорируют ваше предпочтение часового пояса. У каждой — своя причина.

Летнее/зимнее время

PingZen использует модуль zoneinfo Python на бэкенде и Intl.DateTimeFormat на фронтенде. Оба следуют официальной базе IANA, поэтому переходы DST обрабатываются автоматически:

Менять настройку дважды в год не нужно. Аббревиатура рядом со временем автоматически обновляется на границе DST.

FAQ