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

API do conversor de fuso horário - conversão de tempo livre

Converte uma data e hora de um fuso horário IANA para outro. Retorna datas formatadas e a diferença de deslocamento.

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

Coordenar reuniões entre equipes globais

Quando um usuário escolhe um horário de reunião em seu fuso horário local, converta-o para o fuso horário de cada participante e exiba o horário local ao lado do nome. Mostre um aviso se a reunião ocorrer fora das 8h às 20h para qualquer participante.

Normalize os carimbos de data/hora dos eventos para um calendário unificado

Importe eventos de calendário de diferentes serviços que armazenam horários em vários fusos horários. Converta cada evento para o fuso horário local do usuário antes de renderizá-los em uma única visualização de calendário, garantindo a ordem cronológica correta.

Calcular a sobreposição de horário comercial entre escritórios

Para uma empresa distribuída com escritórios em Nova York, Londres e Cingapura, converta das 9h às 17h de cada fuso horário do escritório em uma referência comum. Exiba a janela de sobreposição onde todos os três escritórios estão online.

Frequently asked questions

A conversão lida com as transições de horário de verão?
Sim. A conversão considera as regras de horário de verão nos fusos horários de origem e de destino. Se o horário de origem cair durante uma transição de horário de verão, a resposta refletirá o deslocamento correto.
Qual formato de data e hora devo usar para o parâmetro de hora?
Use o formato ISO 8601: AAAA-MM-DDTHH:mm:ss. Não inclua um deslocamento de fuso horário na string; o parâmetro "from" especifica o fuso horário de origem.
O que é offset_diff?
offset_diff é a diferença em horas e minutos entre os fusos horários de origem e de destino. Por exemplo, +13:00 significa que o fuso horário de destino está 13 horas adiantado em relação ao de origem.
Posso converter de ou para UTC?
Sim. Use "UTC" como parâmetro de ou para. Isso é útil para armazenar carimbos de data/hora em UTC e exibi-los no fuso horário local do usuário.

Get your API key

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