ForHosting KIT · Datas e tempo

Hora local com offset UTC

Transforme um horário UTC em hora local para um offset que você já conhece: 18:45 UTC com +5:45 em Katmandu dá 00:30 do dia seguinte. O resultado mostra se a hora local cai no dia anterior, no mesmo dia ou no seguinte. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Hora UTC: 18:45
Cidade: Kathmandu
Deslocamento (horas): 5
Deslocamento (minutos): 45

Você obtém

Hora local: 00:30
Deslocamento em dias: 1

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. 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

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

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. 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.

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 informo um offset como −03:30?

Digite −3 nas horas e −30 nos minutos. As duas partes precisam ter o mesmo sinal, e um offset de menos de uma hora atrás do UTC usa 0 hora com minutos negativos.

O que significa dia anterior, mesmo dia ou dia seguinte no resultado?

Mostra se a hora local cai no dia antes, no mesmo dia ou no dia depois do horário UTC. A calculadora não usa data, então aplique essa mudança à data que você já conhece.

Quais offsets são aceitos?

Qualquer um de −12:00 a +14:00, incluindo os de meia hora e de quarto de hora, como +05:45. Os minutos precisam ser inteiros entre −59 e 59; valores maiores ou fracionados são recusados em vez de arredondados.

Ferramentas relacionadas

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.

Notas técnicas

Forneça os componentes sinalizados do offset UTC

Digite a parte inteira das horas em offset_hours e os minutos restantes em offset_minutes.

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. Você pode aplicar day_offset à data conhecida com uma biblioteca de calendário adequada. O uso da API custa US$ 0,002 por solicitação, e a mesma lógica pode rodar no navegador.

Perguntas técnicas

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.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Informe a hora UTC de referência e a cidade

Forneça os componentes sinalizados do offset UTC

Interprete a hora local e a mudança de dia

Casos de uso

Preparar uma reunião remota

Montar um itinerário

Padronizar painéis operacionais

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

Forneça os componentes sinalizados do offset UTC

Interprete a hora local e a mudança de dia

Perguntas técnicas

obrigado