Funcionamento da Calculadora de Dias Úteis
A Calculadora de Dias Úteis realiza a contagem exata do intervalo de tempo entre duas datas ou determina uma data futura ou passada com base em um número específico de dias úteis. O cálculo desconsidera automaticamente os finais de semana e quaisquer feriados que o usuário decida listar.
A ferramenta opera em dois modos principais de funcionamento:
- Entre duas datas: Realiza a contagem de dias úteis, dias corridos, finais de semana e feriados contidos no intervalo definido.
- Adicionar ou subtrair: Calcula uma data de destino somando ou subtraindo uma quantidade informada de dias úteis a partir de uma data inicial.
Toda a operação e o processamento dos dados ocorrem diretamente no navegador do usuário. As datas digitadas e as listas de feriados inseridas nunca saem do dispositivo do leitor, garantindo a privacidade das informações.
Diferença entre Dias Úteis e Dias Corridos
A compreensão da diferença entre dias úteis e dias corridos é fundamental para o planejamento de projetos, cumprimento de prazos contratuais e agendamentos logísticos.
- Dias corridos: Representam a totalidade do tempo decorrido no calendário, sem qualquer distinção entre dias de trabalho, descanso ou celebrações.
- Dias úteis: Correspondem apenas aos dias em que há atividade laboral regular. Por padrão, a ferramenta adota a semana de trabalho de segunda a sexta-feira. No entanto, o usuário pode personalizar essa configuração marcando ou desmarcando os dias da semana conforme a necessidade de sua indústria ou escala de trabalho.
Quando se calcula prazos em dias úteis, a ocorrência de finais de semana e feriados prolonga a data final no calendário corrido. A calculadora quantifica exatamente quantos dias de descanso e feriados foram pulados para que se chegue ao resultado final.
Configuração de Dias de Trabalho e Feriados
Diferentes setores do mercado, como o comércio varejista, serviços de saúde e logística, operam com escalas que não seguem o padrão tradicional de segunda a sexta-feira. A ferramenta permite adaptar a semana de trabalho marcando os dias úteis da semana desejados entre segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira, sábado e domingo. É obrigatório que pelo menos um dia útil da semana esteja selecionado para que o cálculo seja processado.
Para a exclusão de feriados, o usuário deve inserir as datas manualmente no campo correspondente. As regras para a inserção da lista de feriados são as seguintes:
- As datas devem ser inseridas uma por linha.
- O formato obrigatório é YYYY-MM-DD (Ano-Mês-Dia).
- Linhas vazias na lista de feriados são desconsideradas pelo sistema.
- A lista é limitada a no máximo 1.000 datas de feriados.
Regras de Contagem e Casos Especiais
O cálculo de datas segue diretrizes matemáticas e de calendário estritas para evitar ambiguidades:
- Direção cronológica inversa: No modo "Entre duas datas", se a data final inserida for anterior à data de início, a calculadora realiza a contagem na ordem cronológica e exibe o aviso: "A data final é anterior à data de início, por isso as duas foram contadas na ordem cronológica.".
- Início da contagem para soma ou subtração: No modo "Adicionar ou subtrair", a contagem dos dias úteis começa sempre no dia seguinte à data de início.
- Soma zero: Adicionar zero dias úteis retorna exatamente a própria data de início.
- Limite de dias: O número máximo de dias úteis que podem ser adicionados ou subtraídos é de 100.000.
- Intervalo de anos suportado: A ferramenta suporta datas contidas entre os anos 1 e 9999.
Mensagens de Erro e Validação
Para garantir a precisão dos resultados, a ferramenta valida todos os dados inseridos e exibe mensagens específicas caso encontre inconsistências:
- Se uma data inválida for inserida nos campos de início ou fim: "Esta não é uma data de calendário válida.".
- Se o campo de quantidade de dias úteis receber um valor não inteiro, negativo ou superior ao limite: "Os dias úteis devem ser um número inteiro de 100.000 ou menos.".
- Se o usuário desmarcar todos os dias da semana: "Selecione pelo menos um dia útil da semana.".
- Se houver um erro de digitação ou formato na lista de feriados: "Esta linha de feriado não é uma data YYYY-MM-DD válida:
{line}" (por exemplo, se for digitado "bad-date", o erro exibido será "Esta linha de feriado não é uma data YYYY-MM-DD válida: bad-date"). - Se a lista de feriados ultrapassar o limite permitido: "A lista de feriados é limitada a 1.000 datas.".
- Se o cálculo resultar em um ano fora do limite do calendário: "O resultado fica fora do intervalo suportado (anos 1–9999).".
Perguntas Frequentes
Quais dias contam como dias úteis?
De segunda a sexta-feira, por padrão. Os botões de dias da semana permitem alterar isso — mantenha o sábado ativado para uma semana de trabalho de seis dias, ou defina sexta e sábado como dias de descanso. Qualquer data listada em feriados também será ignorada.
A ferramenta conhece os feriados nacionais do meu país?
Não — os feriados públicos variam por país, região e ano, e muitos são transferidos de dia quando caem em um fim de semana. Cole os dias de folga do seu próprio calendário, uma data por linha, e exatamente esses dias serão ignorados.
Como é contado “5 dias úteis a partir de hoje”?
A contagem começa no dia seguinte à data de início: cada dia de trabalho conta como um, e o quinto é o resultado. Se você começar em uma sexta-feira, um dia útil depois será segunda-feira. Adicionar zero retorna a própria data de início.