ForHosting KIT · Datas e tempo

Dias úteis entre datas sem fins de semana e feriados

De 1 a 10 de julho de 2026 há 7 dias úteis depois de tirar o fim de semana e o feriado do dia 3. Conte os dias de segunda a sexta entre duas datas, as duas incluídas, e desconte os seus próprios fechamentos. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Início: 2026-07-01
End: 2026-07-10
Feriados: 2026-07-03, 2026-07-04, 2026-07-03

Você obtém

Dias úteis líquidos: 7
Dias corridos: 10
Feriados excluídos: 1

Esta calculadora conta os dias de segunda a sexta-feira entre duas datas ISO explícitas e retira os feriados úteis informados por você. As duas pontas são incluídas, o que atende cronogramas auditáveis, níveis de serviço, prazos de faturas e relatórios de equipes. Ao inverter as datas, o resultado fica negativo sem mudar de magnitude. O cálculo usa aritmética gregoriana pura, sem relógio ou fuso horário local, e sempre produz o mesmo resultado.

Defina o intervalo e a direção com precisão

Envie start e end como datas reais no formato estrito YYYY-MM-DD. O intervalo inclui as duas pontas: uma segunda-feira usada como início e fim vale um dia útil. De sexta a segunda, contam-se a sexta e a segunda, mas não o sábado e o domingo.

A ordem das entradas determina a direção. Quando start é anterior ou igual a end, o resultado é positivo ou zero. Quando start é posterior, a calculadora avalia o mesmo período inclusivo e troca o sinal das duas contagens.

Portanto, inverter as datas altera somente o sinal. São aceitos os anos 0001 a 9999 no calendário gregoriano proléptico.

Exclua fins de semana e feriados explícitos sem ambiguidade

Todo dia de segunda a sexta no intervalo começa como útil; sábados e domingos são excluídos automaticamente. O array opcional holidays permite retirar fechamentos específicos da sua organização sem depender de uma base nacional que possa mudar ou escolher a região errada. Cada feriado deve usar o mesmo formato ISO estrito.

Uma data fora do intervalo não afeta o cálculo, e um feriado no fim de semana não é descontado novamente. Entradas repetidas são deduplicadas. Informe as datas efetivamente observadas pela organização, inclusive folgas compensatórias, pois a ferramenta não presume calendários legais, celebrações regionais ou recessos empresariais.

Use resultados determinísticos em sistemas operacionais

A implementação faz aritmética inteira sobre ano, mês e dia gregorianos. Ela nunca chama o construtor Date do JavaScript, lê o relógio do sistema, consulta um fuso horário, acessa a rede ou usa aleatoriedade. Uma solicitação executada em qualquer país, navegador ou nó de borda devolve o mesmo objeto.

Essa estabilidade evita falhas em mudanças de horário de verão, quando abordagens baseadas em timestamp podem criar dias de vinte e três ou vinte e cinco horas. Também permite reproduzir resultados históricos apenas com as entradas armazenadas. Em rotinas recorrentes, guarde a lista de feriados junto da versão da política que a produziu e armazene entradas e resultado.

A execução gratuita no navegador utiliza o mesmo solucionador puro, sendo adequada para validar exemplos antes de automatizá-los.

Casos de uso

Medir a duração de um SLA

Conte os dias úteis da abertura à resolução de um chamado, removendo as datas de fechamento da sua equipe.

Auditar desvios de entrega

Compare dois marcos com um valor direcional que muda de sinal quando as datas são invertidas.

Calcular prazos financeiros

Conte os dias úteis de uma fatura ou liquidação e informe os feriados bancários que seu processo observa.

Perguntas frequentes

As datas inicial e final são incluídas?

Sim. As duas pontas pertencem ao intervalo e contam quando são dias úteis não listados como feriados.

Por que o resultado pode ser negativo?

Se start for posterior a end, a contagem inclusiva será negada. Inverter as datas preserva a magnitude e troca o sinal.

A ferramenta carrega automaticamente os feriados de um país?

Não. Informe as datas exatas que deseja excluir para evitar premissas regionais ocultas e manter o resultado reproduzível.

Fuso horário ou horário de verão afetam a resposta?

Não. O solucionador usa aritmética gregoriana pura com semântica UTC e não consulta o fuso local nem o relógio.

E se um feriado cair no fim de semana ou aparecer duas vezes?

Não muda nada. O sábado e o domingo já ficam de fora, e um feriado repetido é descontado uma única vez: no exemplo de julho de 2026, o dia 4 e o dia 3 duplicado tiram um só dia.

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

POSThttps://api.kit.forhosting.com/date/net-workdays-between

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/date/net-workdays-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-07-01","end":"2026-07-10"}'

const res = await fetch("https://api.kit.forhosting.com/date/net-workdays-between", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start": "2026-07-01",
    "end": "2026-07-10"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/net-workdays-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2026-07-01",
    "end": "2026-07-10"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/net-workdays-between", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start":"2026-07-01","end":"2026-07-10"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start":"2026-07-01","end":"2026-07-10"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/net-workdays-between", 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

{
  "start": "2026-07-01",
  "end": "2026-07-10"
}

Exemplo de resposta

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

Limites

max_holidays 10000

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

Defina o intervalo e a direção com precisão

Essa convenção também aparece em calendar_days com sinal, facilitando a auditoria da integração. As datas são validadas, não normalizadas: 30 de fevereiro, mês 13, falta de zeros, timestamps e formatos locais geram invalid_input em vez de uma resposta aparentemente válida.

Exclua fins de semana e feriados explícitos sem ambiguidade

A resposta inclui excluded_holidays, que conta apenas feriados únicos que realmente removeram um dia de segunda a sexta dentro do intervalo. Assim, você consegue explicar a diferença em relação a uma conta que considera apenas os fins de semana. Ao inverter as datas, a exclusão permanece simétrica: esse indicador não tem sinal, enquanto net_workdays mostra a direção.

Use resultados determinísticos em sistemas operacionais

Use net_workdays para diferenças com sinal, calendar_days para conferir rapidamente a extensão inclusiva e excluded_holidays para rastreabilidade. O preço da API é US$ 0,002 por solicitação, e um intervalo completo conta como um item.

Perguntas técnicas

Como feriados repetidos ou no fim de semana são tratados?

Duplicatas são removidas e feriados no fim de semana não descontam novamente. excluded_holidays mostra só feriados úteis únicos do intervalo.

Quanto custa uma solicitação de API?

Uma solicitação de API bem-sucedida custa US$ 0,002. O mesmo cálculo determinístico também é gratuito no navegador.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Defina o intervalo e a direção com precisão

Exclua fins de semana e feriados explícitos sem ambiguidade

Use resultados determinísticos em sistemas operacionais

Casos de uso

Medir a duração de um SLA

Auditar desvios de entrega

Calcular prazos financeiros

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

Defina o intervalo e a direção com precisão

Exclua fins de semana e feriados explícitos sem ambiguidade

Use resultados determinísticos em sistemas operacionais

Perguntas técnicas

obrigado