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

API конвертера часовых поясов — бесплатное преобразование времени

Преобразует дату и время из одного часового пояса IANA в другой. Возвращает как форматированные дату и время, так и разницу смещений.

Parameters

stringrequired

ISO 8601 datetime string (YYYY-MM-DDTHH:mm:ss).

stringrequired

Source IANA timezone.

stringrequired

Target IANA timezone.

Code examples

curl -X POST https://api.botoi.com/v1/timezone/convert \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-03-24T10:30:00","from":"America/New_York","to":"Asia/Tokyo"}'

When to use this API

Координируйте встречи между глобальными командами

Когда пользователь выбирает время встречи в своем местном часовом поясе, преобразуйте его в часовой пояс каждого участника и отображайте местное время рядом с его именем. Показывать предупреждение, если собрание для любого участника приходится на период с 8:00 до 20:00.

Нормализация временных меток событий для единого календаря.

Импортируйте события календаря из разных сервисов, которые хранят время в разных часовых поясах. Преобразуйте каждое событие в местный часовой пояс пользователя, прежде чем отображать их в одном представлении календаря, обеспечивая правильный хронологический порядок.

Рассчитать перекрытие рабочих часов между офисами

Для распределенной компании с офисами в Нью-Йорке, Лондоне и Сингапуре преобразуйте часы с 9:00 до 17:00 из часового пояса каждого офиса в общую ссылку. Отобразите окно перекрытия, в котором все три офиса находятся в режиме онлайн.

Frequently asked questions

Справляется ли преобразование с переходом на летнее время?
Да. Преобразование учитывает правила летнего времени как в исходном, так и в целевом часовом поясе. Если исходное время выпадает во время перехода на летнее время, ответ отражает правильное смещение.
Какой формат даты и времени следует использовать для параметра времени?
Используйте формат ISO 8601: ГГГГ-ММ-ДДТЧЧ:мм:сс. Не включайте в строку смещение часового пояса; параметр «from» указывает часовой пояс источника.
Что такое offset_diff?
offset_diff — это разница в часах и минутах между исходным и целевым часовыми поясами. Например, +13:00 означает, что целевой часовой пояс на 13 часов опережает исходный.
Могу ли я конвертировать в UTC или обратно?
Да. Используйте «UTC» в качестве параметра from или to. Это полезно для хранения временных меток в формате UTC и их отображения в местном часовом поясе пользователя.

Get your API key

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