ForHosting KIT · Ferramentas para dev

Calculadora de sequência de hábitos: atual e recorde

Esta calculadora transforma uma lista de datas de conclusão em duas medidas úteis: a sequência de dias consecutivos encerrada na data mais recente e a maior sequência de todo o histórico.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

As datas podem estar fora de ordem, e registros repetidos contam apenas uma vez. Assim, você pode usar diretamente exportações de aplicativos, diários ou planilhas. O cálculo considera dias do calendário, não horas locais transcorridas, e permanece estável entre fusos horários e mudanças do horário de verão.

Prepare um histórico confiável de conclusões

Informe cada data em que o hábito foi concluído no formato YYYY-MM-DD. A lista não precisa estar ordenada, pois a calculadora organiza as datas antes de medir qualquer sequência. Repetições também não causam problema: se um aplicativo exportou a mesma conclusão duas vezes, aquele dia contribui apenas uma vez. Uma conclusão realizada em qualquer horário representa o dia inteiro; por isso, horários, carimbos de data e deslocamentos de fuso não são aceitos. Essa escolha mantém claro o significado da sequência e impede que dois registros no mesmo dia pareçam dois dias de progresso. Inclua o histórico completo para obter uma maior sequência confiável, e não apenas o último mês ou a parte visível em um painel. A lista deve conter pelo menos uma data, e cada item precisa representar uma data real. Valores como 30 de fevereiro, datas parciais ou textos em outro formato são rejeitados em vez de corrigidos silenciosamente. Essa validação rigorosa ajuda você a identificar exportações defeituosas antes que elas produzam um recorde enganoso.

Entenda a sequência atual e o recorde

A sequência atual é o conjunto de dias consecutivos que termina na data de conclusão mais recente fornecida por você. Essa definição não consulta a data de hoje; portanto, a mesma entrada sempre retorna a mesma resposta, e exportações históricas continuam reproduzíveis. Por exemplo, quando os últimos registros são segunda, terça e quarta-feira, a sequência atual é 3 mesmo que o cálculo seja feito posteriormente. A ausência da terça-feira interrompe uma sequência entre segunda e quarta, pois os dias precisam ser adjacentes no calendário. A maior sequência é o maior conjunto desse tipo em todo o histórico, podendo ser mais antigo e maior que o atual. O resultado também apresenta a quantidade de dias únicos de conclusão e a última data usada, facilitando a confirmação de que duplicatas foram removidas e o histórico correto foi recebido. Dias bissextos e mudanças de mês ou ano são tratados como datas adjacentes comuns. Essas regras fornecem métricas úteis sem depender do relógio do dispositivo nem da localização de quem faz a consulta.

Use o resultado em acompanhamentos e análises

Use a sequência atual para resumir o ritmo no fim do histórico registrado e a maior sequência como referência pessoal. Um aplicativo de hábitos pode calcular ambas após importar um registro de eventos, enquanto um fluxo de planilha pode enviar uma coluna de datas e salvar as métricas ao lado de uma análise mensal. Como a ordem da entrada não interfere, os clientes dispensam uma etapa separada de ordenação. E como duplicatas contam uma vez, novas tentativas e exportações combinadas não aumentam o resultado indevidamente. Ainda assim, interprete as sequências com cuidado: elas medem a regularidade registrada, não o esforço, a qualidade ou o benefício de longo prazo. Se o hábito prevê dias de descanso ou segue uma agenda semanal, uma sequência rígida de dias consecutivos talvez não represente o comportamento que você deseja incentivar. Nesse caso, transforme as datas segundo sua própria programação antes de usar a calculadora. As solicitações à API usam o preço-base exibido de US$ 0,002. A versão do navegador executa a mesma lógica pura, sem rede, aleatoriedade ou dependência da data atual.

Adicione sequências a um aplicativo de hábitos

Calcule o ritmo atual e o recorde histórico sempre que uma pessoa importar ou atualizar datas de conclusão.

Analise uma exportação de diário

Converta uma coluna de registros datados em métricas claras de regularidade sem ordenar as entradas manualmente.

Una históricos de acompanhamento

Combine datas de várias fontes sem permitir que conclusões duplicadas aumentem qualquer sequência.

O que significa sequência atual?

É o conjunto de dias consecutivos encerrado na data mais recente do histórico fornecido. Não há comparação com a data de hoje.

Datas duplicadas aumentam a sequência?

Não. Cada data do calendário conta uma vez, mesmo quando aparece repetida na entrada.

As datas precisam estar ordenadas?

Não. Elas são validadas, deduplicadas e ordenadas antes do cálculo das sequências.

O que acontece se a lista estiver vazia?

A solicitação retorna um erro de entrada inválida, pois não é possível calcular uma sequência sem ao menos uma data de conclusão.

Anos bissextos e mudanças de mês são aceitos?

Sim. Datas válidas e adjacentes continuam consecutivas nas mudanças de mês e ano e na passagem por um dia bissexto.

Quanto custa uma solicitação à API?

Cada solicitação à API usa o preço-base de US$ 0,002.

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.

POSThttps://api.kit.forhosting.com/final3/habit-streak-calculate

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/final3/habit-streak-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dates":["2026-07-20","2026-07-21","2026-07-23","2026-07-24","2026-07-25"]}'
{
  "dates": [
    "2026-07-20",
    "2026-07-21",
    "2026-07-23",
    "2026-07-24",
    "2026-07-25"
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.habit_streak_calculate",
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →