ForHosting KIT · Ferramentas para dev

Hora local com offset UTC

A calculadora de hora local com offset UTC transforma uma hora conhecida em UTC no horário correspondente de uma cidade quando você já sabe o offset fixo.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe a hora UTC, um nome de cidade e os componentes com sinal de horas e minutos. O resultado mostra a hora local e se ela cai no dia anterior, no mesmo dia ou no dia seguinte. Nenhuma consulta de fuso, rede, relógio do sistema ou suposição sobre horário de verão interfere no cálculo; entradas iguais sempre geram a mesma resposta.

Informe a hora UTC de referência e a cidade

Comece com uma hora expressa em Tempo Universal Coordenado e use rigorosamente o formato de 24 horas HH:MM. Meia-noite é 00:00, meio-dia é 12:00 e o último minuto válido é 23:59. O campo de cidade apenas identifica o resultado; ele não solicita uma pesquisa geográfica. Informar Kathmandu, por exemplo, não faz a calculadora consultar um serviço de fusos nem decidir qual offset está vigente. Você deve fornecer o offset adequado para a data e a situação. Essa separação é importante porque cidades podem adotar horário de verão, governos podem mudar regras civis e offsets históricos podem ser diferentes dos atuais. Consulte uma fonte confiável, determine primeiro o offset aplicável e só então combine-o com a hora UTC. O formato rígido evita valores ambíguos, e o nome da cidade facilita exibir a resposta em agendas, relatórios, painéis e mensagens sem sugerir que a localização foi verificada.

Forneça os componentes sinalizados do offset UTC

Digite a parte inteira das horas em offset_hours e os minutos restantes em offset_minutes. Componentes positivos representam um relógio adiantado em relação a UTC; componentes negativos representam um relógio atrasado. O offset +05:45 usa 5 horas e 45 minutos, enquanto -03:30 usa -3 horas e -30 minutos. Componentes diferentes de zero devem ter o mesmo sinal para deixar a direção inequívoca. Para um offset negativo menor que uma hora, use zero nas horas e um valor negativo nos minutos. O intervalo total permitido vai de -12:00 a +14:00. Os minutos precisam ser inteiros entre -59 e 59; frações e valores excessivos são recusados, não arredondados. Depois da validação, a calculadora converte o offset completo em minutos com sinal e o soma aos minutos desde a meia-noite UTC. Essa abordagem aceita offsets de meia hora e de quinze minutos sem usar horas decimais imprecisas.

Interprete a hora local e a mudança de dia

O campo local_time contém o horário convertido no formato HH:MM de 24 horas, com zeros à esquerda. day_offset mostra como o dia local se relaciona ao dia da referência UTC: -1 significa o dia anterior, 0 o mesmo dia e 1 o dia seguinte. Um offset positivo aplicado perto do fim do dia pode atravessar a meia-noite; um offset negativo logo após a meia-noite UTC pode voltar uma data. Como nenhuma data de calendário é recebida, a calculadora não inventa mês, dia da semana ou nova data. Você pode aplicar day_offset à data conhecida com uma biblioteca de calendário adequada. A resposta preserva a cidade, os dois horários e os componentes do offset, permitindo auditar a conta sem interpretar texto. O algoritmo usa somente inteiros limitados e independe do fuso, idioma ou relógio da máquina. Entradas inválidas geram um erro tipado. O uso da API custa US$ 0,002 por solicitação, e a mesma lógica pode rodar no navegador.

Casos de uso

Preparar uma reunião remota

Converta uma reunião marcada em UTC para o relógio da cidade de um participante quando o offset aplicável já for conhecido.

Montar um itinerário

Mostre o horário do destino e preserve o indicador de mudança de dia em uma agenda criada com registros UTC.

Padronizar painéis operacionais

Transforme horários UTC em exibições por cidade com offset fixo sem depender do fuso configurado no servidor.

Perguntas frequentes

A calculadora descobre o offset UTC atual da cidade?

Não. Você fornece o offset, e a cidade serve como identificação descritiva da resposta.

Ela considera o horário de verão?

Não. Informe o offset fixo aplicável ao local e à data após considerar qualquer regra sazonal.

Como informar um offset UTC-03:30?

Use -3 em offset_hours e -30 em offset_minutes para que ambos os componentes indiquem atraso em relação a UTC.

O que significa day_offset?

Ele vale -1 para o dia anterior, 0 para o mesmo dia ou 1 para o dia seguinte em relação à referência UTC.

Quanto custa uma solicitação via API?

Cada solicitação via API custa US$ 0,002. A lógica determinística também pode ser executada diretamente no navegador.

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/date/local-time-from-offset

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/date/local-time-from-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'

const res = await fetch("https://api.kit.forhosting.com/date/local-time-from-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/local-time-from-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/local-time-from-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/local-time-from-offset", 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

{
  "utc_time": "18:45",
  "city": "Kathmandu",
  "offset_hours": 5
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.local_time_from_offset",
  "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 →