Перейти к содержимому
POST AI agent ready /v1/timezone

API часового пояса — бесплатный поиск текущего времени

Возвращает текущее время, смещение UTC, аббревиатуру и статус летнего времени для данного часового пояса IANA. По умолчанию используется UTC, если часовой пояс не указан.

Parameters

stringrequired

IANA timezone name (e.g. America/New_York, Europe/London).

Code examples

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

Отображение локализованных часов на информационной панели

Создайте виджет часов с несколькими часовыми поясами для информационной панели команды. Вызовите эту конечную точку для часового пояса каждого члена команды (например, Америка/Нью-Йорк, Европа/Берлин, Азия/Токио) и отобразите текущее местное время рядом с его именем.

Запланируйте уведомления в рабочее время по местному времени

Прежде чем отправлять push-уведомление или электронное письмо, проверьте часовой пояс получателя и убедитесь, что он находится между 9:00 и 18:00 по местному времени. Отложите доставку до следующего бизнес-окна, чтобы улучшить показатели открываемости и избежать перерывов в нерабочее время.

Frequently asked questions

Какой формат часового пояса принимает эта конечная точка?
Он принимает идентификаторы часовых поясов IANA, такие как Америка/Нью-Йорк, Европа/Лондон или Азия/Токио. Полный список доступен по адресу iana.org/time-zones.
Учитывает ли ответ летнее время?
Да. Поле is_dst указывает, активно ли летнее время, а utc_offset отражает текущее смещение, включая любые корректировки летнего времени.
Что произойдет, если я передам неверный часовой пояс?
Конечная точка возвращает ошибку 400 с сообщением, объясняющим, что идентификатор часового пояса не распознан.
Могу ли я использовать это, чтобы получить текущее время UTC?
Да. Либо опустите параметр часового пояса (по умолчанию — UTC), либо явно укажите «UTC», чтобы получить текущее всемирное координированное время.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.