Categorias

Calculador de Dias Úteis

Calcular dias úteis entre duas datas, excluindo fins de semana e feriados

Fatos principais

Categoria
Utilities
Tipos de entrada
text, select, checkbox, number
Tipo de saída
json
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Calculador de Dias Úteis é uma ferramenta prática para determinar com precisão o número de dias de trabalho entre duas datas, permitindo a exclusão automática de fins de semana e feriados nacionais ou personalizados.

Quando usar

  • Planejamento de prazos de projetos e cronogramas de entrega.
  • Cálculo de períodos de carência ou vencimento de pagamentos.
  • Gestão de escalas de trabalho e controle de horas produtivas.

Como funciona

  • Insira a data inicial e a data final no formato AAAA-MM-DD.
  • Selecione o país correspondente para aplicar o calendário oficial de feriados.
  • Marque as opções para excluir fins de semana e feriados conforme sua necessidade.
  • Adicione datas específicas em 'Feriados Personalizados' para ajustar o cálculo ao seu contexto local.

Casos de uso

Estimativa de prazos de entrega para clientes baseada em dias úteis.
Cálculo de juros ou multas por atraso em dias de expediente bancário.
Organização de cronogramas de equipes remotas considerando feriados locais.

Exemplos

1. Planejamento de Projeto

Gerente de Projetos
Contexto
Preciso entregar um relatório técnico em 30 dias úteis, mas preciso descontar os feriados brasileiros.
Problema
Calcular a data final exata excluindo fins de semana e feriados nacionais do Brasil.
Como usar
Defina a data inicial, selecione 'Brazil' no campo de país e certifique-se de que 'Incluir Feriados Públicos' esteja marcado.
Configuração de exemplo
startDate: 2024-05-01, country: BR, includeHolidays: true, excludeWeekends: true
Resultado
O sistema retorna o número exato de dias úteis disponíveis no período, garantindo um cronograma realista.

2. Cálculo de Vencimento de Fatura

Analista Financeiro
Contexto
Uma fatura vence em 5 dias úteis, mas há um feriado municipal não listado no calendário padrão.
Problema
Determinar a data de vencimento correta considerando um feriado específico da empresa.
Como usar
Insira a data de emissão, selecione 'None' para feriados nacionais e adicione a data do feriado municipal no campo de personalizados.
Configuração de exemplo
startDate: 2024-11-15, customHolidays: 2024-11-20, excludeWeekends: true
Resultado
A ferramenta exclui o feriado personalizado do cálculo, fornecendo a data de vencimento precisa.

Testar com amostras

utilities

Hubs relacionados

FAQ

Como o cálculo lida com feriados?

A ferramenta utiliza uma base de dados de feriados nacionais do país selecionado e subtrai essas datas do total de dias úteis.

Posso adicionar feriados que não estão na lista padrão?

Sim, utilize o campo 'Feriados Personalizados' para inserir datas específicas separadas por vírgulas.

O cálculo inclui o dia inicial e final?

O cálculo considera o intervalo entre as datas; você pode ajustar a contagem dependendo de como define o início do seu período.

É possível calcular dias úteis sem excluir fins de semana?

Sim, basta desmarcar a opção 'Excluir Fins de Semana' nas configurações da ferramenta.

Para que serve a precisão decimal?

A precisão decimal permite definir o número de casas decimais no resultado, útil para cálculos financeiros ou de produtividade detalhados.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/working-days-calculator

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
startDate text Sim -
endDate text Sim -
country select Não -
includeHolidays checkbox Não -
excludeWeekends checkbox Não -
customHolidays text Não -
precision number Não -

Formato de resposta

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Dados JSON: Dados JSON

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-working-days-calculator": {
      "name": "working-days-calculator",
      "description": "Calcular dias úteis entre duas datas, excluindo fins de semana e feriados",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=working-days-calculator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]