Percentual de tempo
Aos 15 minutos de uma reunião de 60, já passou 25 % do tempo. Digite o tempo decorrido e a duração total na mesma unidade e receba a parte usada, o que falta e um status que vai de não iniciado a tempo excedido. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Total
- 60
- Tempo decorrido
- 15
- Restante
- 45
- Razão
- 0,25
- Porcentagem
- 25
- Porcentagem restante
- 75
Esta calculadora de percentual de tempo responde a uma pergunta prática: se você já sabe quanto tempo passou e quanto o intervalo inteiro deve durar, que porcentagem dessa duração já foi consumida. Você informa os dois valores na mesma unidade — segundos, minutos, horas ou dias — e a calculadora divide o tempo decorrido pela duração total e multiplica por cem. Quinze minutos de uma reunião de sessenta são vinte e cinco por cento. Quarenta e cinco minutos de uma aula de noventa são cinquenta por cento.
O que o percentual de tempo decorrido significa e o que não é
O percentual de tempo é a fatia de uma duração planejada que já foi usada, escrita como por cento dessa duração. A identidade é única e curta: divida o tempo decorrido pela duração total e multiplique por cem. Quinze de sessenta é um quarto, e um quarto vezes cem é vinte e cinco por cento.
Noventa de cento e vinte são três quartos, ou seja, setenta e cinco por cento. Tempo decorrido zero é zero por cento: o relógio ainda não começou. Quando o decorrido iguala o total, o resultado é cem por cento e o intervalo está concluído.
Quando o decorrido ultrapassa o total, o percentual sobe de cem e o tempo restante fica negativo; essa leitura de hora extra é honesta para uma reunião que se alongou ou um cronômetro que não foi parado. Esta página não é uma caixa geral de porcentagens que mistura «por cento de», «que por cento é», aumento, queda e inverso. Não é uma variação percentual com sinal de um valor antigo para um novo.
Não é o progresso de um ano civil, que precisa de uma data e de um ano gregoriano em vez de duas durações que você já mediu. Não é um percentual de nota a partir de acertos sobre um total de pontos, embora a aritmética se pareça: a busca e os rótulos falam de tempo, de tempo restante e de progresso, não de letras nem de faixas de prova.
Quem digita percentual de tempo, porcentagem do tempo decorrido ou que por cento do tempo já passou já tem duas durações e quer a fatia decorrida. Os dois números precisam usar a mesma unidade. Misturar minutos com horas escala a resposta por sessenta em silêncio; a calculadora não converte unidades porque não consegue adivinhar qual relógio você quis dizer.
O total fica no denominador, então precisa ser um número finito positivo.
Onde uma calculadora de percentual de tempo se paga
Equipes de produto e operações alimentam barras de progresso com dois relógios que já possuem: segundos de um vídeo já reproduzidos contra a duração do clipe, milissegundos de um download contra o total estimado, ou minutos de uma reunião contra o horário reservado. Professores e quem redige provas querem um oráculo determinístico para «que por cento do período já passou» que também cubra um zero ainda não iniciado e uma leitura de hora extra acima de cem, não só a fração arrumada do primeiro exemplo de sala.
Quem planeja projetos e turnos compara as horas já trabalhadas com a duração prevista e precisa do tempo restante na mesma resposta para um painel mostrar a fatia usada e o que sobra. Validação falha não consome saldo. Mantenha as requisições pequenas, fixe percentage e remaining nos testes e você obtém progresso de tempo reproduzível para players, salas e workers na borda sem montar um motor de calendário nem uma pilha de álgebra simbólica.
Casos de uso
Progresso de reuniões, aulas e turnos
Informe os minutos já usados e a duração reservada em elapsed e total para relatar quanto do horário foi consumido e quanto resta, inclusive hora extra quando o relógio passa do fim.
Checagens de sala e provas
Deixe o alunado verificar «quinze de sessenta minutos é vinte e cinco por cento» e os casos equivalentes de zero, conclusão e hora extra, inclusive o erro de duração nula que um Infinity silencioso esconderia.
Perguntas frequentes
Como se calcula que percentual de uma duração já passou?
Envie os números finitos elapsed e total na mesma unidade.
O que acontece quando a duração total é zero ou negativa?
O percentual de tempo divide pela duração total, então um total nulo ou negativo é indefinido; essas falhas não são cobradas.
O tempo decorrido pode ser maior que a duração total?
Sim. Hora extra é permitida. Cento e cinquenta minutos de um horário de cem minutos devolvem percentage 150, um remaining negativo e status overtime.
elapsed e total precisam usar a mesma unidade?
Sim. A calculadora é agnóstica de unidade: os dois valores devem ser segundos, ou ambos minutos, ou ambos horas, ou ambos dias. Ela não converte entre unidades.
Como vejo quanto tempo falta?
O resultado mostra também o tempo restante, que é o total menos o decorrido, e a parte que falta, que é 100 menos a porcentagem. No exemplo de 15 em 60, faltam 45, ou seja, 75 %.
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
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/percent-time \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"elapsed":15,"total":60}'const res = await fetch("https://api.kit.forhosting.com/math/percent-time", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"elapsed": 15,
"total": 60
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/math/percent-time",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"elapsed": 15,
"total": 60
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/percent-time", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"elapsed":15,"total":60}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"elapsed":15,"total":60}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/percent-time", 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
{
"elapsed": 15,
"total": 60
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.percent_time",
"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
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
Uma duração total nula ou negativa é indefinida, então esse caso falha com invalid_input em vez de Infinity.
O que o percentual de tempo decorrido significa e o que não é
Uma duração nula ou negativa deixa a fatia relativa indefinida, e esta calculadora informa isso como invalid_input em vez de Infinity ou NaN.
Contrato de entrada, forma da resposta e erros
Um tempo decorrido negativo é recusado porque o tempo decorrido não anda para trás. Um total nulo ou negativo é recusado porque a fórmula divide pela duração; essas falhas também não são cobradas. Em sucesso o corpo ecoa os valores elapsed e total limpos, devolve remaining como total menos elapsed, ratio como elapsed dividido por total, e percentage como resultado principal. Exemplo: elapsed cento e cinquenta e total cem produz percentage cento e cinquenta, remaining menos cinquenta e status overtime. Envie por POST um corpo JSON com dois números finitos obrigatórios: elapsed, o tempo não negativo já usado, e total, a duração positiva de todo o intervalo. Cada campo pode chegar como número JSON ou como string numérica. Alias comuns são aceitos quando o nome canônico é omitido: elapsed_time, spent, used ou passed para elapsed; total_duration, duration, total_time ou allotted para total. Campos ausentes, strings vazias, texto não numérico, NaN e Infinity falham com invalid_input nomeando o campo e não são cobrados. Também devolve remaining_percent como cem menos o percentual, nomeia status como not_started, in_progress, complete ou overtime, reitera a string de fórmula e inclui uma mensagem de uma linha que você pode colocar ao lado de uma barra de progresso. Exemplo: elapsed quinze e total sessenta produz remaining quarenta e cinco, ratio zero ponto vinte e cinco, percentage vinte e cinco, remaining_percent setenta e cinco e status in_progress. Combine a carga com seus próprios rótulos ou traçados; este endpoint não emite gráficos.
Onde uma calculadora de percentual de tempo se paga
Um endpoint dedicado a decorrido sobre total evita reimplementar a identidade em cada linguagem de cliente, onde um esquecimento de multiplicar por cem ou um par trocado pinta em silêncio uma barra em quatro por cento em vez de quarenta. Como a implementação é parse de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.
Casos de integração
Barras de vídeo, download e cronômetro
Converta os segundos reproduzidos contra a duração do clipe, ou o tempo equivalente de uma transferência contra uma estimativa, em um percentage e um remaining_percent que você pode ligar a uma barra de progresso sem um auxiliar sob medida.
Perguntas técnicas
Quanto custa a calculadora de percentual de tempo?
A ferramenta do navegador é grátis. As requisições à API usam saldo pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.