ForHosting KIT · Ferramentas para dev

Calculadora de blocos de tempo por dia

A calculadora de blocos de tempo por dia transforma a jornada, a reserva para pausas e a duração desejada de cada bloco em uma capacidade diária prática.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Primeiro ela separa as pausas e depois conta apenas os blocos completos que cabem no período restante. Também informa tempo útil, minutos agendados, sobra e utilização, para que você planeje uma agenda realista sem tratar uma fração como sessão completa.

Comece pelo tempo que você realmente controla

Informe toda a duração da jornada em minutos, e não uma estimativa otimista de produtividade. Um expediente de oito horas tem, por exemplo, 480 minutos. Depois, indique o total que deseja reservar para almoço, pequenos descansos e outras pausas planejadas. A calculadora desconta essa reserva antes de considerar qualquer bloco de foco. Use como duração do bloco uma sessão sem interrupções, como 25, 45, 50 ou 90 minutos. Os três valores são minutos inteiros, facilitando a transferência para o calendário. A jornada e o bloco precisam ser positivos, e as pausas não podem exceder a jornada. Elas podem ocupar o dia inteiro, gerando zero minuto disponível. O limite de 1,440 minutos mantém o cálculo dentro de um único dia.

Entenda o cálculo de blocos completos

A ferramenta subtrai as pausas da jornada para obter o orçamento disponível de foco. Em seguida, divide esse valor pela duração solicitada e arredonda para baixo. Se restarem 420 minutos e o bloco durar 50, cabem oito blocos completos; os 20 minutos restantes não viram um nono. O resultado mostra quantidade, minutos comprometidos e sobra. A utilização divide o foco agendado pelo disponível e é arredondada para duas casas decimais. Sem tempo restante, ela vale zero. O modelo usa uma reserva conjunta e não insere pausas automaticamente entre blocos. Se sua rotina exige cinco intervalos de dez minutos, inclua os 50 minutos. Reuniões, tarefas administrativas e deslocamentos também podem entrar na reserva quando impedirem trabalho concentrado.

Transforme o resultado em um plano diário realista

Considere a quantidade de blocos como capacidade, não como obrigação de preencher todos os espaços. Uma agenda precisa de transições, perguntas inesperadas e margem para tarefas que terminem antes ou depois. A sobra revela se a duração escolhida encaixa bem ou preserva um intervalo útil. Compare durações mantendo jornada e pausas constantes: blocos curtos podem elevar a quantidade, enquanto blocos longos podem reduzir mudanças de contexto. Em equipes, defina o que integra as pausas antes de comparar números. O cálculo é determinístico e pode alimentar planilhas, ferramentas internas ou automações. Uma chamada de API custa US$ 0,002. Acompanhe por alguns dias quantos blocos você realmente conclui e ajuste os dados; um plano menor e confiável vale mais que uma agenda lotada que invade descansos ou tempo pessoal.

Casos de uso

Criar uma agenda pessoal de foco

Reserve almoço e recuperação e veja quantas sessões completas de escrita, programação ou estudo cabem.

Estimar a capacidade de entrega da equipe

Converta disponibilidade e política de pausas comuns em uma quantidade consistente por integrante.

Comparar rotinas de blocos de tempo

Teste blocos de 25, 50 ou 90 minutos no mesmo dia e compare quantidade, sobra e utilização.

Perguntas frequentes

O que conta como tempo de pausa?

Inclua todos os minutos que você deseja excluir antes do agendamento, como almoço, descansos, reuniões ou administração.

Por que blocos parciais não são contados?

Somente sessões completas entram na conta; uma sobra menor aparece como tempo de foco não utilizado.

A ferramenta adiciona pausas entre blocos?

Não. Informe a reserva diária total, inclusive os intervalos entre blocos que você pretende fazer.

As pausas podem ocupar a jornada inteira?

Sim. O resultado mostrará zero minuto disponível, zero bloco e utilização igual a zero.

Quanto custa um cálculo pela API?

Cada chamada de API custa US$ 0,002. O cálculo é determinístico e não usa serviços externos.

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/biz/time-blocks-per-day

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/biz/time-blocks-per-day \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workday_minutes":480,"break_minutes":60,"block_minutes":50}'

const res = await fetch("https://api.kit.forhosting.com/biz/time-blocks-per-day", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "workday_minutes": 480,
    "break_minutes": 60,
    "block_minutes": 50
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/time-blocks-per-day",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "workday_minutes": 480,
    "break_minutes": 60,
    "block_minutes": 50
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/time-blocks-per-day", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"workday_minutes":480,"break_minutes":60,"block_minutes":50}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"workday_minutes":480,"break_minutes":60,"block_minutes":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/time-blocks-per-day", 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

{
  "workday_minutes": 480,
  "break_minutes": 60,
  "block_minutes": 50
}

Exemplo de resposta

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

Ver a documentação completa do KIT →