POST AI agent ready /v1/timezone/convert

Timezone Converter API - Free Time Conversion

Converts a datetime from one IANA timezone to another. Returns both formatted datetimes and the offset difference.

Endpoint

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

Coordinate meetings across global teams

When a user picks a meeting time in their local timezone, convert it to each attendee's timezone and display the local time next to their name. Show a warning if the meeting falls outside 8am-8pm for any participant.

Normalize event timestamps for a unified calendar

Import calendar events from different services that store times in various timezones. Convert every event to the user's local timezone before rendering them on a single calendar view, ensuring correct chronological ordering.

Calculate business-hours overlap between offices

For a distributed company with offices in New York, London, and Singapore, convert 9am-5pm from each office timezone to a common reference. Display the overlap window where all three offices are online.

Frequently asked questions

Does the conversion handle daylight saving transitions?

Yes. The conversion accounts for DST rules in both the source and target timezones. If the source time falls during a DST transition, the response reflects the correct offset.

What datetime format should I use for the time parameter?

Use ISO 8601 format: YYYY-MM-DDTHH:mm:ss. Do not include a timezone offset in the string; the "from" parameter specifies the source timezone.

What is offset_diff?

offset_diff is the difference in hours and minutes between the source and target timezones. For example, +13:00 means the target timezone is 13 hours ahead of the source.

Can I convert to or from UTC?

Yes. Use "UTC" as the from or to parameter. This is useful for storing timestamps in UTC and displaying them in a user's local timezone.

Get your API key

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