Fim do filme: some duração, trailers e anúncios
O horário anunciado de uma sessão raramente informa quando você realmente sairá do cinema.
Executar grátis
Esta calculadora combina o início programado, a duração do filme e uma margem separada para trailers ou publicidade. Ela retorna um horário final claro no formato de 24 horas e indica quando a exibição termina depois da meia-noite. Você pode usá-la para planejar transporte, jantar, cuidados infantis, estacionamento ou uma segunda sessão sem fazer contas de horário mentalmente. O cálculo é determinístico e mantém a duração do filme separada da margem opcional do conteúdo exibido antes dele.
Informe o horário da sessão e a duração oficial
Comece pelo horário impresso no ingresso ou divulgado pelo cinema, usando o relógio de 24 horas, como 19:30. Em seguida, informe a duração oficial do filme em minutos inteiros. A duração precisa ser maior que zero, pois um filme com zero minuto ou duração negativa não gera uma estimativa válida. Solicitações de API aceitam aliases comuns, mas usar start_time e runtime_minutes deixa a integração mais fácil de compreender posteriormente. Considere a duração oficial como o tempo do longa-metragem em si. Se o cinema já publicar um horário final que inclua o programa anterior, não copie essa duração combinada para o campo de duração. Manter os valores separados torna o resultado auditável e permite ajustar a parte incerta sem alterar o tempo conhecido do filme. Por exemplo, um filme de 142 minutos iniciado às 19:30 termina às 21:52 quando nenhuma margem é incluída. O horário informado é normalizado para dois dígitos; assim, 9:05 retorna como 09:05 sem mudar o significado.
Acrescente uma margem realista para trailers e anúncios
Use buffer_minutes para trailers, publicidade, avisos do cinema ou qualquer atraso previsto entre o horário anunciado e o início do longa. A margem padrão é zero, o que atende a festivais, sessões particulares, reprodução em casa ou locais que informam precisamente o início do filme. Cinemas comerciais costumam apresentar conteúdo prévio, mas a duração varia conforme a rede, a unidade, o dia e a sessão; por isso, a calculadora não presume uma margem universal. Informe o valor compatível com os dados disponíveis. Uma margem de 20 minutos somada a um filme de 142 minutos cria um tempo total de 162 minutos. A partir das 19:30, isso resulta em término estimado às 22:12. A margem deve ser zero ou um número inteiro positivo. Como ela aparece separadamente na resposta, você consegue comparar cenários: calcule com a média habitual do cinema e repita com uma estimativa cautelosa caso uma conexão ou reserva seja importante. Trata-se de uma conta para planejamento, não de uma garantia sobre o momento exato em que a projeção começará.
Entenda a virada do dia e planeje a partir da estimativa
O resultado inclui end_time, total_minutes e day_offset. O horário final é normalizado no formato de 24 horas. O deslocamento de dia é zero quando o filme acaba na mesma data do início, um quando termina depois da meia-noite seguinte e pode ser maior em entradas de teste excepcionalmente longas. Isso elimina ambiguidades: end_time igual a 00:25 acompanhado de day_offset 1 significa claramente 12:25 da madrugada do dia seguinte, e não um horário anterior da data inicial. O cálculo soma a duração e a margem diretamente ao horário da sessão; ele não usa fuso horário, calendário, hora atual nem regras de horário de verão. Assim, permanece estável e adequado a programações locais, nas quais todos os valores seguem o mesmo relógio. Para compromissos práticos, considere acrescentar uma margem pessoal ao resultado para créditos, banheiro, retirada de pertences, trajeto até o carro ou caminhada até o transporte. A calculadora estima o fim do programa informado, não a rapidez com que você conseguirá sair do local.
Casos de uso
Planejar a volta para casa
Estime o término antes de agendar um transporte, consultar o último trem ou escolher a duração do estacionamento.
Organizar jantar ou cuidados infantis
Transforme horário e duração em uma previsão prática para reservas, babás ou compromissos familiares.
Comparar sessões
Calcule vários horários com a mesma duração e margem do cinema para encontrar a sessão adequada à sua noite.
Perguntas frequentes
Quanto custa a calculadora?
O uso no navegador é gratuito. Cada solicitação de API custa US$ 0,002.
A duração do filme normalmente inclui trailers?
A duração oficial costuma descrever apenas o longa. Informe trailers e anúncios separadamente em buffer_minutes quando necessário.
O que acontece quando o filme termina depois da meia-noite?
end_time retorna ao relógio de 24 horas e day_offset passa a 1, indicando claramente um término no dia seguinte.
A duração pode ser zero ou negativa?
Não. Ela deve ser um número inteiro positivo de minutos; zero e valores negativos retornam um erro de entrada inválida.
Posso omitir a margem de trailers e anúncios?
Sim. buffer_minutes usa zero como padrão, portanto o resultado soma somente a duração do filme ao horário inicial.
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/video/movie-runtime-showtime-calc \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"runtime_minutes":142,"start_time":"19:30"}'const res = await fetch("https://api.kit.forhosting.com/video/movie-runtime-showtime-calc", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"runtime_minutes": 142,
"start_time": "19:30"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/movie-runtime-showtime-calc",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"runtime_minutes": 142,
"start_time": "19:30"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/movie-runtime-showtime-calc", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"runtime_minutes":142,"start_time":"19:30"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"runtime_minutes":142,"start_time":"19:30"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/movie-runtime-showtime-calc", 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
{
"runtime_minutes": 142,
"start_time": "19:30"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.movie_runtime_showtime_calc",
"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.
Limites
max_mb | 500 |
max_minutes | 60 |
max_megapixels | 3.9 |
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. |