ForHosting KIT · Matemática

Calcular diferença horária entre offsets UTC

UTC−5 e UTC+5:30 estão separados por 10,5 horas, com o segundo à frente. Digite dois offsets fixos entre UTC−12 e UTC+14 e receba a distância em horas, a diferença com sinal e qual dos dois está adiantado. 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

Deslocamento A: -5
Deslocamento B: 5,5

Você obtém

Diferença com sinal em horas: 10,5
Diferença em horas: 10,5
Adiantado: b
Adiantado em horas: 10,5

Esta calculadora compara dois offsets fixos em relação ao Tempo Universal Coordenado e informa a distância em horas, a diferença com sinal de A para B e qual deles está adiantado. Informe horas inteiras ou valores fracionários, como 5.5 para UTC+05:30. O cálculo usa somente os offsets fornecidos; não consulta locais, datas, horário de verão nem bancos de fusos horários. Os dois valores devem ficar entre UTC-12 e UTC+14.

Entenda a diferença entre offsets

Um offset UTC indica quanto um relógio local se afasta do Tempo Universal Coordenado. UTC+3 está três horas à frente de UTC, enquanto UTC-4 está quatro horas atrás. Portanto, a comparação exige subtração com os sinais corretos.

Esta calculadora define o resultado com sinal como offset B menos offset A. Se A for UTC-4 e B for UTC+3, o resultado será +7 e B estará sete horas à frente. Ao inverter os valores, o resultado será -7 e A ficará à frente.

A distância absoluta continua sendo sete. Se forem iguais, a diferença será zero e nenhum estará adiantado. A ferramenta compara apenas números fixos: não deduz offsets de cidades, países, abreviações ou nomes de fusos e não determina se o horário de verão vale em uma data específica.

Informe os valores e interprete a resposta

Inteiros representam UTC-8, UTC ou UTC+10; decimais permitem frações: 5.5 equivale a cinco horas e trinta minutos e 5.75, a cinco horas e quarenta e cinco minutos. São aceitos valores de -12 a +14, inclusive. Comparar -5 com 5.5, por exemplo, retorna 10.5 e informa que B está adiantado.

Use com segurança em agendas e sistemas

Use este cálculo quando a fonte já apresentar offsets UTC explícitos. Um convite pode mostrar UTC+1, um log de servidor pode usar UTC e uma tabela de transporte pode indicar UTC+9. Nesses casos, a comparação é exata e dispensa suposições geográficas.

Se a fonte trouxer Europe/London ou America/New_York, obtenha primeiro o offset correto para a data, pois regras sazonais e históricas podem alterá-lo. A faixa permitida vai de UTC-12 a UTC+14, com os limites incluídos; assim, a maior separação possível é 26 horas. Valores externos são rejeitados, nunca ajustados silenciosamente.

Ela serve para conferir planilhas, validar configurações, montar testes e manter serviços pequenos sem depender de um banco de fusos horários.

Casos de uso

Comparar expedientes de equipes remotas

Confira a distância fixa entre duas equipes depois que cada uma informar seu offset UTC aplicável.

Validar cálculos de horários

Confirme qual offset publicado está à frente antes de converter reuniões, transmissões ou transportes.

Criar casos de teste determinísticos

Gere diferenças estáveis, com sinal e absolutas, sem depender de um banco de fusos horários.

Perguntas frequentes

Como a diferença com sinal é calculada?

O offset A é subtraído do offset B. Resultado positivo significa B à frente; resultado negativo significa A à frente.

Posso usar offsets de meia hora ou quinze minutos?

Sim. Informe horas decimais, como 5.5 para cinco horas e trinta minutos ou 5.75 para cinco horas e quarenta e cinco minutos.

Qual faixa é aceita?

Cada valor deve estar entre -12 e +14 horas, inclusive.

O cálculo considera o horário de verão?

Não. Ele compara os offsets fixos informados e não resolve datas nem nomes de fusos horários.

O que ocorre quando os offsets são iguais?

As diferenças com sinal e absoluta são zero, e a resposta informa que nenhum está adiantado.

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/math/time-zone-offset-diff

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/math/time-zone-offset-diff \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset_a":-5,"offset_b":5.5}'

const res = await fetch("https://api.kit.forhosting.com/math/time-zone-offset-diff", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "offset_a": -5,
    "offset_b": 5.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/time-zone-offset-diff",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "offset_a": -5,
    "offset_b": 5.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/time-zone-offset-diff", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"offset_a":-5,"offset_b":5.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"offset_a":-5,"offset_b":5.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/time-zone-offset-diff", 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

{
  "offset_a": -5,
  "offset_b": 5.5
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.time_zone_offset_diff",
  "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

Informe os valores e interprete a resposta

Envie offset_a e offset_b como números finitos de horas. Dado ausente, texto, infinito ou número fora dessa faixa gera invalid_input. signed_difference_hours corresponde a B menos A; difference_hours é a distância não negativa. ahead será b quando B for maior, a quando A for maior e neither quando forem iguais. ahead_by_hours facilita a exibição direta e summary traz uma frase curta. Cada automação pela API custa US$ 0,002, e o navegador executa a mesma função pura.

Use com segurança em agendas e sistemas

A função não usa rede, relógio atual, aleatoriedade nem Date, portanto a mesma entrada JSON sempre gera a mesma saída.

Perguntas técnicas

Quanto custa uma solicitação de API?

Uma solicitação de API bem-sucedida custa US$ 0,002. Você também pode executar o mesmo cálculo determinístico no navegador.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Entenda a diferença entre offsets

Informe os valores e interprete a resposta

Use com segurança em agendas e sistemas

Casos de uso

Comparar expedientes de equipes remotas

Validar cálculos de horários

Criar casos de teste determinísticos

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

Informe os valores e interprete a resposta

Use com segurança em agendas e sistemas

Perguntas técnicas

obrigado