POST AI agent ready /v1/timezone/convert

API de conversión de zona horaria: conversión de hora gratuita

Convierte una fecha y hora de una zona horaria de la IANA a otra. Devuelve tanto las fechas y horas formateadas como la diferencia de compensación.

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

Coordinar reuniones entre equipos globales.

Cuando un usuario elige una hora de reunión en su zona horaria local, conviértala a la zona horaria de cada asistente y muestre la hora local junto a su nombre. Muestre una advertencia si la reunión se realiza fuera de las 8 a. m. a 8 p. m. para cualquier participante.

Normalizar las marcas de tiempo de eventos para un calendario unificado

Importe eventos de calendario de diferentes servicios que almacenan horas en varias zonas horarias. Convierta cada evento a la zona horaria local del usuario antes de representarlos en una única vista de calendario, asegurando un orden cronológico correcto.

Calcular la superposición de horarios comerciales entre oficinas

Para una empresa distribuida con oficinas en Nueva York, Londres y Singapur, convierta de 9:00 a. m. a 5:00 p. m. de cada zona horaria de oficina en una referencia común. Muestre la ventana superpuesta donde las tres oficinas están en línea.

Frequently asked questions

¿La conversión maneja las transiciones de horario de verano?

Sí. La conversión tiene en cuenta las reglas de horario de verano tanto en la zona horaria de origen como en la de destino. Si la hora de origen cae durante una transición de horario de verano, la respuesta refleja el desplazamiento correcto.

¿Qué formato de fecha y hora debo usar para el parámetro de hora?

Utilice el formato ISO 8601: AAAA-MM-DDTHH:mm:ss. No incluya un desplazamiento de zona horaria en la cadena; el parámetro "desde" especifica la zona horaria de origen.

¿Qué es offset_diff?

offset_diff es la diferencia en horas y minutos entre las zonas horarias de origen y de destino. Por ejemplo, +13:00 significa que la zona horaria de destino está 13 horas por delante de la de origen.

¿Puedo convertir hacia o desde UTC?

Sí. Utilice "UTC" como parámetro desde o hasta. Esto es útil para almacenar marcas de tiempo en UTC y mostrarlas en la zona horaria local de un usuario.

Get your API key

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