ForHosting KIT · Ferramentas para dev

Converter fuso horário

Converta qualquer data e hora entre fusos horários — de Brasília para UTC, de Nova York para Manaus — com o horário de verão de cada lugar aplicado automaticamente. A conta certa, na hora, no seu navegador: sem app, sem cadastro e sem aritmética mental às 7 da manhã.

● EstávelGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Brasília não é o Brasil inteiro

O país tem quatro fusos: Fernando de Noronha (UTC-2), Brasília (UTC-3), Manaus (UTC-4) e Acre (UTC-5). Uma reunião marcada às 14h entre São Paulo e Rio Branco tem duas horas de diferença embutida — e sistemas que assumem horário do Brasil como coisa única erram para todo usuário fora do eixo. Ao converter, use sempre a cidade, não o país: America/Sao_Paulo e America/Manaus são fusos diferentes.

O horário de verão que pega todo mundo

O Brasil aboliu o horário de verão em 2019, mas Estados Unidos e Europa continuam adiantando e atrasando o relógio duas vezes por ano — em datas diferentes entre si. Resultado: a diferença entre São Paulo e Nova York oscila entre uma e duas horas conforme o mês. A reunião semanal com o cliente de fora, sempre no mesmo horário de lá, muda para o lado brasileiro duas vezes por ano. A conversão correta considera a data, não só o lugar.

Logs de servidor: as 3 horas erradas que não são erro

Servidores bem configurados gravam logs em UTC — e todo dev brasileiro já perdeu minutos procurando um erro das 14h que no log está às 17h. Não é bug: é o deslocamento de três horas entre UTC e Brasília. Antes de investigar um incidente, converta o intervalo de interesse para UTC e busque por ele; depois converta de volta os horários encontrados para montar a linha do tempo em horário local.

Conversão dentro dos seus sistemas

Agendadores, relatórios e integrações internacionais precisam converter fusos programaticamente — e bibliotecas mal usadas erram exatamente nos dias de transição de horário de verão. A conversão via API custa US$ 0,002 por chamada e devolve o horário certo considerando as regras vigentes de cada zona, sem você manter tabela de deslocamentos à mão. Na página, o uso é grátis e sem limite.

Casos de uso

Reunião com cliente no exterior

A agência fecha um call com o cliente de Lisboa às 15h de lá. Convertendo com a data certa, descobre que naquela semana Portugal está em horário de verão — e o call cai às 11h de Brasília, não às 12h.

Investigar incidente pelo log

O sistema caiu perto do meio-dia segundo os usuários. O analista converte 11h30 a 12h30 de Brasília para UTC, filtra o log de 14h30 às 15h30 e encontra a exceção em minutos.

Agendar promoção nacional

Um e-commerce programa a virada da Black Friday para meia-noite. Convertendo para os fusos do país, o time decide disparar por região — para o cliente de Manaus não ver a oferta uma hora antes de o estoque abrir.

Perguntas frequentes

O Brasil ainda tem horário de verão?

Não — foi abolido em 2019 e não há adiantamento de relógio desde então. Mas atenção: outros países mantêm, e é por isso que a diferença entre Brasília e Nova York, por exemplo, varia durante o ano.

Qual a diferença entre UTC-3 e America/Sao_Paulo?

UTC-3 é um deslocamento fixo; America/Sao_Paulo é uma zona com histórico e regras — que hoje resulta em UTC-3, mas nem sempre resultou. Para sistemas, prefira sempre o nome da zona: se as regras mudarem, a conversão continua certa.

Por que meu log de servidor mostra 3 horas a mais?

O servidor grava em UTC, o padrão correto para infraestrutura. Brasília é UTC-3, então 14h locais aparecem como 17h no log. Converta o intervalo antes de buscar, e não ajuste o relógio do servidor — o problema não está nele.

A conversão considera a data ou só o lugar?

A data importa tanto quanto o lugar: por causa do horário de verão alheio, converter 10 de janeiro e 10 de julho entre as mesmas cidades pode dar resultados diferentes. A ferramenta calcula com a data que você informar.

O que eu converto aqui é registrado em algum lugar?

Não — o cálculo roda no navegador e nenhum dado sai da página. Agenda de reuniões e horários de incidentes ficam só com você.

Dá para converter fusos direto do meu sistema?

Sim, via API: US$ 0,002 por chamada, preço publicado, sem mensalidade. O jeito de acertar agendamentos internacionais sem manter regras de fuso dentro do seu código.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/dev/timezone

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/dev/timezone \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/dev/timezone", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/timezone",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/timezone", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/timezone", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.timezone",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →

Executar grátis