Ir al contenido
POST AI agent ready /v1/timezone

API de zona horaria: búsqueda gratuita de la hora actual

Devuelve la hora actual, el desplazamiento UTC, la abreviatura y el estado de DST para una zona horaria de IANA determinada. El valor predeterminado es UTC si no se especifica ninguna zona horaria.

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

Mostrar relojes localizados en un panel

Cree un widget de reloj con varias zonas horarias para el panel de un equipo. Llame a este punto final para la zona horaria de cada miembro del equipo (por ejemplo, América/Nueva_York, Europa/Berlín, Asia/Tokio) y muestre la hora local actual junto a su nombre.

Programe notificaciones en el horario comercial local

Antes de enviar una notificación automática o un correo electrónico, verifique la zona horaria del destinatario para confirmar que es entre las 9 a. m. y las 6 p. m., hora local. Retrase la entrega hasta la próxima ventana comercial para mejorar las tasas de apertura y evitar interrupciones fuera del horario laboral.

Frequently asked questions

¿Qué formato de zona horaria acepta este punto final?
Acepta identificadores de zona horaria de IANA como América/Nueva_York, Europa/Londres o Asia/Tokio. La lista completa se mantiene en iana.org/time-zones.
¿La respuesta tiene en cuenta el horario de verano?
Sí. El campo is_dst indica si el horario de verano está activo y utc_offset refleja el desplazamiento actual, incluido cualquier ajuste de horario de verano.
¿Qué sucede si paso por una zona horaria no válida?
El punto final devuelve un error 400 con un mensaje que explica que no se reconoce el identificador de zona horaria.
¿Puedo usar esto para obtener la hora UTC actual?
Sí. Omita el parámetro de zona horaria (el valor predeterminado es UTC) o pase explícitamente "UTC" para obtener la hora universal coordinada actual.

Get your API key

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