ForHosting KIT · Datas e tempo

Dias úteis de projeto

De segunda, 6, a sexta, 10 de julho de 2026, um projeto tem 5 dias úteis, e marcar 8 de julho como feriado deixa 4. Informe início, fim e folgas e receba o total de dias de trabalho. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Início
2026-07-06
End
2026-07-10
Você obtém
Dias úteis
5
Dias corridos
5
Dias de fim de semana
0
Feriados excluídos
0

Os cronogramas de projeto quase nunca significam dias de calendário brutos. Quando um escopo promete trinta dias úteis a partir do kickoff, ou um cliente pergunta quantos dias faturáveis existem entre dois marcos, fins de semana e feriados distorcem em silêncio qualquer subtração ingênua de duas datas ISO. Esta calculadora de dias úteis de projeto aceita uma data de início, uma data de fim e uma lista opcional de feriados, e devolve a contagem inclusiva de segunda a sexta que resta após remover esses feriados.

O que é um dia útil de projeto nesta calculadora

Um dia útil de projeto é qualquer dia do calendário gregoriano que cai em segunda, terça, quarta, quinta ou sexta e não está listado no array opcional holidays. O intervalo é inclusivo: se a data de início for um dia útil e não for feriado, conta como o dia um da janela do projeto; se a data de fim também for dia útil, conta igualmente. Sábados e domingos nunca contam, mesmo dentro de um engajamento de vários meses.

Feriados que caem no fim de semana não alteram o total, porque esses dias já foram excluídos como fim de semana; só feriados em dia de semana reduzem o total de dias úteis, e essas datas aparecem na lista holidays da resposta para que a auditoria veja exatamente quais dias úteis não laboráveis foram aplicados.

Onde a contagem de dias úteis de projeto vale a pena

Equipes de entrega usam uma calculadora de dias úteis de projeto ao traduzir durações contratuais em dias úteis para datas de calendário, ou ao medir quantos dias faturáveis já se passaram entre o kickoff e uma revisão de status. Gestores de produto que planejam sprints precisam de contagens inclusivas de dias úteis que ignorem feriados da empresa listados uma vez por região.

Finanças e operações de serviços profissionais conciliam folhas de ponto com o máximo teórico de dias úteis de um período de faturamento sem abrir planilha de desktop para cada cliente.

Janelas de dias úteis em contratos e SOW

Meça dias úteis inclusivos entre o kickoff do projeto e o fim contratual, subtraindo fins de semana e a lista de feriados do escopo.

Capacidade de sprint e período de faturamento

Calcule a capacidade máxima de dias úteis de um sprint ou período mensal para que planejamento e finanças compartilhem o mesmo total.

Tempo decorrido em SLA e marcos

Informe quantos dias úteis se passaram entre dois marcos em relatórios de status, sem contar sábados, domingos nem fechamentos listados.

Como conto dias úteis de projeto entre duas datas?

Envie start e end como YYYY-MM-DD. Opcionalmente passe holidays como array no mesmo formato.

E se um feriado cair no fim de semana?

Feriados de fim de semana não alteram o total.

O dia de início e o dia de fim entram na conta?

Sim. O período é inclusivo: o primeiro e o último dia contam como úteis sempre que caem de segunda a sexta e não estão na sua lista de feriados.

O que acontece se eu colocar o fim antes do início?

A calculadora recusa o par em vez de inverter as datas. Um projeto que termina antes de começar quase sempre é erro de digitação, e é melhor perceber isso do que receber um resultado enganoso.

E se eu digitar o mesmo feriado duas vezes?

Repetições são ignoradas, então um feriado anotado duas vezes desconta só um dia. O resultado também lista os feriados em dia útil que foram descontados, para qualquer pessoa conferir.

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/date/business-days-project

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/date/business-days-project \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-07-06","end":"2026-07-31"}'
{
  "start": "2026-07-06",
  "end": "2026-07-31"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.business_days_project",
  "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.

Validação falha não é cobrada; chamadas bem-sucedidas usam o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída.

O que é um dia útil de projeto nesta calculadora

O algoritmo percorre cada dia civil do início ao fim com aritmética pura: números seriais seguem Howard Hinnant days_from_civil, dias da semana o método Sakamoto e anos bissextos a regra gregoriana de que séculos só são bissextos quando divisíveis por quatrocentos. Nenhum objeto JavaScript Date é construído, assim a resposta é idêntica em cada região Worker e em testes offline.

Contrato de entrada, campos de resposta e erros

Cada data é validada como dia gregoriano real, incluindo 29 de fevereiro só em anos bissextos, de modo que 2023-02-29 é rejeitado e 2024-02-29 é aceito. Exemplo: start 2026-07-06 (segunda) e end 2026-07-10 (sexta) sem feriados rende cinco dias úteis, cinco dias de calendário e zero fins de semana. A mesma semana com holidays contendo 2026-07-08 rende quatro dias úteis e uma entrada em holidays. Envie um corpo JSON com start e end como strings de calendário ISO-8601 obrigatórias no formato YYYY-MM-DD. holidays é um array opcional das mesmas strings; omita-o ou passe um array vazio quando o projeto não tiver fechamentos fora do fim de semana. Aliases são aceitos por conveniência: from, begin e project_start mapeiam para start; to, finish e project_end para end. start deve ser anterior ou igual a end; um par invertido falha com invalid_input em vez de trocar limites em silêncio, porque uma janela de projeto invertida quase sempre é bug de entrada de dados que vale a pena expor. Em sucesso o corpo devolve as strings normalizadas start e end, business_days como contagem inclusiva de dias úteis, calendar_days como o intervalo inclusivo de todos os dias, weekend_days como a contagem de sábados e domingos no intervalo, holidays_excluded como o número de feriados em dia de semana que de fato reduziram o total, holidays como a lista ordenada desses feriados dentro do intervalo, e uma string formula curta com a regra. Datas inválidas ou ausentes, um valor holidays que não seja array, ou start depois de end geram invalid_input e não são cobrados.

Onde a contagem de dias úteis de projeto vale a pena

Mantenha as requisições pequenas, fixe business_days nos testes de integração e obtenha janelas de projeto reproduzíveis para ferramentas Gantt, motores de SLA, prévias de fatura e edge workers sem montar um serviço de calendário completo próprio.

As datas de início e fim são incluídas?

Sim. Ambos os limites são inclusivos: se start ou end for dia útil e não for feriado listado, soma um a business_days.

start pode ser depois de end?

Não. A tarefa falha com invalid_input quando start é posterior a end, para não trocar em silêncio janelas de projeto invertidas.

Quanto custa a calculadora de dias úteis de projeto?

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

Ver a documentação completa do KIT →