ForHosting KIT · Casa, cozinha e lazer

Duração entre horários

De 09:30 a 14:45 são 5 horas e 15 minutos, e um plantão noturno das 22:15 às 06:40 passa da meia-noite sem erro. Digite dois horários no formato de 24 horas, sem data, e veja as horas e os minutos decorridos. 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 de início: 09:30
Hora de término: 14:45

Você obtém

Início: 09:30
End: 14:45
Horas: 5
Minutos: 15

Quanto tempo há entre 09:30 e 17:45? E um turno noturno que começa às 22:15 e termina às 06:40? Uma calculadora de duração entre horários responde a essas perguntas do dia a dia sem pedir uma data de calendário: você informa dois horários no formato de 24 horas e recebe as horas e os minutos decorridos, cruzando a meia-noite quando o fim é anterior ao início. Horários inválidos como 25:00 ou 9:30 AM são rejeitados em vez de reinterpretados em silêncio. Não há chamada de rede, nem relógio do sistema, nem aleatoriedade: só minutos desde a meia-noite e, se preciso, um único acréscimo de vinte e quatro horas.

Como dois horários de relógio viram horas e minutos

Um horário no formato de vinte e quatro é uma posição no dia civil circular, não uma duração nem uma data de calendário. Nove e meia da manhã são quinhentos e setenta minutos depois da meia-noite; quatorze e quarenta e cinco são oitocentos e oitenta e cinco minutos depois da meia-noite.

Subtrair essas contagens de minutos desde a meia-noite dá o intervalo decorrido quando as duas leituras caem no mesmo dia civil: oitocentos e oitenta e cinco menos quinhentos e setenta são trezentos e quinze minutos, que se partem em cinco horas e quinze minutos.

Quando o fim é anterior ao início — um turno noturno das vinte e duas e quinze às seis e quarenta, um estacionamento que cruza a meia-noite, uma janela de sono das vinte e três e dez às seis e cinquenta — uma subtração ingênua fica negativa.

A regra de duração de relógio soma então mil quatrocentos e quarenta minutos, o comprimento de um dia civil, de modo que o intervalo cruza a meia-noite uma vez e permanece no intervalo fechado de zero horas e zero minutos até vinte e três horas e cinquenta e nove minutos. Início e fim iguais rendem tempo decorrido zero, não um dia inteiro, porque as duas leituras nomeiam o mesmo instante no mostrador.

Onde uma calculadora de duração de relógio se paga

Recorre-se a uma calculadora de duração de relógio quando duas leituras de mostrador precisam virar um comprimento sem inventar uma data de calendário. Sistemas de estacionamento e garagem cotam a permanência da hora de entrada até a de saída, inclusive um cruzamento noturno quando o carro sai depois da meia-noite. Pais e treinadores cronometram um treino que começa às dezesseis em ponto e termina às dezessete e quarenta e cinco.

Enfermagem, despacho e recepção de hotel calculam um intervalo que começa tarde e termina cedo na manhã seguinte. Alunos que aprendem tempo decorrido conferem que de 09:30 a 14:45 há cinco horas e quinze minutos, e não um erro de empréstimo no papel. Como a ferramenta recusa cadeias de doze horas AM/PM e horas ilegais, ela também serve de validador de formato de vinte e quatro horas para formulários de entrada que não devem aceitar 25:00.

Combine esta página com uma ferramenta de diferença de datas ou de contagem regressiva se também precisar de dias inteiros entre datas de calendário, ou com uma calculadora para somar tempo se precisar somar duas durações em vez de subtrair dois mostradores.

Casos de uso

Turno noturno e horas que cruzam a meia-noite

Transforme um início às 22:15 e um fim às 06:40 em oito horas e vinte e cinco minutos para uma folha que pede tempo de mostrador, não horas decimais.

Permanência de estacionamento e de consulta

Calcule quanto durou um carro, um horário de fórum ou uma visita clínica da hora de entrada até a de saída, inclusive um cruzamento da meia-noite.

Checagens escolares de tempo decorrido

Deixe os alunos conferirem que de 09:30 a 14:45 há cinco horas e quinze minutos, e que 25:00 é rejeitado como horário de 24 horas ilegal.

Perguntas frequentes

O que acontece se o horário de fim for anterior ao de início?

O intervalo é tratado como um único cruzamento da meia-noite. De 22:15 a 06:40 o resultado é 8 horas e 25 minutos e overnight é verdadeiro. Horários iguais rendem zero, não um dia inteiro.

Quais formatos de relógio são aceitos?

Só H:MM ou HH:MM de 24 horas, com hora 0–23 e minuto 00–59. Zeros à esquerda na hora são opcionais. Segundos, instantes ISO e o formato de 12 horas AM/PM são rejeitados.

Por que 9:30 AM ou 25:00 são rejeitados?

Este contrato é um mostrador de 24 horas.

E se o horário de início e o de fim forem iguais?

O resultado é zero, não um dia inteiro. Dois horários iguais apontam o mesmo momento no mostrador do relógio, então a calculadora não supõe que 24 horas se passaram entre eles.

Dá para medir um período de mais de 24 horas?

Não. A conta passa da meia-noite uma única vez, então os resultados vão de zero a 23 horas e 59 minutos. Para vários dias, use uma ferramenta que conte entre datas do calendário.

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/life/clock-duration

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/life/clock-duration \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_time":"09:30","end_time":"14:45"}'

const res = await fetch("https://api.kit.forhosting.com/life/clock-duration", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_time": "09:30",
    "end_time": "14:45"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/clock-duration",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_time": "09:30",
    "end_time": "14:45"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/clock-duration", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_time":"09:30","end_time":"14:45"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_time":"09:30","end_time":"14:45"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/clock-duration", 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

{
  "start_time": "09:30",
  "end_time": "14:45"
}

Exemplo de resposta

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

Como dois horários de relógio viram horas e minutos

O algoritmo nunca consulta o relógio do sistema, nunca chama um serviço de rede e nunca usa aleatoriedade, de modo que o mesmo par de cadeias de relógio sempre produz as mesmas horas, minutos, total_minutes e a bandeira overnight.

Contrato de entrada, formato de vinte e quatro horas e erros

Cada uma deve ser um horário de relógio de vinte e quatro válido na forma H:MM ou HH:MM, com a hora um inteiro de zero a vinte e três e o minuto um inteiro de dois dígitos de zero a cinquenta e nove. Zeros à esquerda na hora são opcionais, de modo que nove e cinco e 09:05 nomeiam o mesmo instante. Um campo ausente, uma string vazia após o recorte ou um valor que não seja string também falham, porque este contrato é um formato de mostrador de relógio, não um somador de durações nem um analisador de texto livre. Entrada inválida não é cobrada. O corpo da requisição traz duas strings obrigatórias: start_time e end_time. Cadeias de doze horas como 9:30 AM, instantes ISO que incluem uma data de calendário, horários com segundos como 14:30:00 e valores fora da faixa como 24:00, 25:00 ou 12:60 falham com invalid_input e nomeiam o campo culpado. Os aliases start, from e begin são aceitos para start_time; os aliases end, to, until e stop são aceitos para end_time, para que formulários e scripts usem o nome que já têm. No sucesso, a resposta devolve os dois horários normalizados para HH:MM de dois dígitos, as horas e os minutos decorridos como inteiros, total_minutes como a contagem inteira exata de minutos, overnight como um booleano que só é verdadeiro quando o fim era anterior ao início, uma cadeia pretty como 5h 15m e uma fórmula curta que você pode imprimir ao lado da resposta. Chamadas API bem-sucedidas usam o preço-base publicado US$ 0,002.

Onde uma calculadora de duração de relógio se paga

Supervisores de turno convertem um start_time e um end_time em horas e minutos para uma folha que recusa horas decimais. Isso mantém a latência em um punhado de operações aritméticas e o modelo de custo honesto em US$ 0,002 por requisição API bem-sucedida, enquanto uma validação falha nunca consome saldo pré-pago.

Perguntas técnicas

Como calcular o tempo decorrido entre dois horários de relógio?

Envie start_time e end_time como strings HH:MM de 24 horas. A API converte cada uma em minutos desde a meia-noite, subtrai, soma 1440 minutos se o fim for anterior e devolve horas mais minutos.

Quanto custa a calculadora de duração de relógio?

A ferramenta do navegador é gratuita. Pedidos API usam saldo pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como dois horários de relógio viram horas e minutos

Onde uma calculadora de duração de relógio se paga

Casos de uso

Turno noturno e horas que cruzam a meia-noite

Permanência de estacionamento e de consulta

Checagens escolares de tempo decorrido

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

Como dois horários de relógio viram horas e minutos

Contrato de entrada, formato de vinte e quatro horas e erros

Onde uma calculadora de duração de relógio se paga

Perguntas técnicas

obrigado