Pular para o conteúdo
POST AI agent ready /v1/timezone

API de fuso horário - pesquisa gratuita de hora atual

Retorna a hora atual, o deslocamento UTC, a abreviatura e o status do horário de verão para um determinado fuso horário da IANA. O padrão é UTC se nenhum fuso horário for especificado.

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

Exibir relógios localizados em um painel

Crie um widget de relógio com vários fusos horários para um painel de equipe. Chame esse endpoint para o fuso horário de cada membro da equipe (por exemplo, América/Nova_Iorque, Europa/Berlim, Ásia/Tóquio) e renderize a hora local atual ao lado de seu nome.

Agende notificações no horário comercial local

Antes de enviar uma notificação push ou e-mail, verifique o fuso horário do destinatário para confirmar que é entre 9h e 18h, horário local. Adie a entrega até a próxima janela comercial para melhorar as taxas de abertura e evitar interrupções fora do horário comercial.

Frequently asked questions

Qual formato de fuso horário esse endpoint aceita?
Ele aceita identificadores de fuso horário da IANA, como América/Nova Iorque, Europa/Londres ou Ásia/Tóquio. A lista completa é mantida em iana.org/time-zones.
A resposta leva em conta o horário de verão?
Sim. O campo is_dst indica se o horário de verão está ativo e utc_offset reflete o deslocamento atual, incluindo qualquer ajuste de horário de verão.
O que acontece se eu passar um fuso horário inválido?
O endpoint retorna um erro 400 com uma mensagem explicando que o identificador de fuso horário não foi reconhecido.
Posso usar isso para obter a hora UTC atual?
Sim. Omita o parâmetro de fuso horário (o padrão é UTC) ou passe explicitamente "UTC" para obter o Tempo Universal Coordenado atual.

Get your API key

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