Dia útil mais próximo de uma data
Digite uma data e receba o dia útil mais próximo, de segunda a sexta: um sábado vira a sexta anterior, um domingo vira a segunda seguinte e os dias úteis continuam iguais. Útil para prazos e fechamento de folha. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data
- 2024-03-16
- Resultado
- 2024-03-15
- Dias de deslocamento
- -1
- Dia da semana base
- Saturday
- Dia da semana base (ISO)
- 6
Esta calculadora do dia útil mais próximo de uma data recebe um único dia do calendário gregoriano no formato estrito YYYY-MM-DD e devolve o dia de segunda a sexta mais próximo, calculado como data civil pura em UTC. Quando a entrada já cai de segunda a sexta, o resultado é essa mesma data com deslocamento de zero dias. Quando a entrada é um sábado, o motor recua um dia até sexta-feira; quando é um domingo, avança um dia até segunda-feira — o dia útil mais próximo e inequívoco numa semana de sete dias, sem feriados. Verificações clássicas incluem 2024-03-16 (sábado) mapeado para 2024-03-15 (sexta-feira), 2024-03-17 (domingo) para 2024-03-18 (segunda-feira) e 2024-03-15 (sexta-feira) permanecendo inalterado.
O que significa o dia útil mais próximo e o que a resposta contém
Encontrar o dia de segunda a sexta mais próximo responde a uma pergunta diferente da próxima ocorrência de um dia da semana com nome, do dia da semana anterior ou de deslocamentos multi-dia por dias úteis: pergunta qual único dia civil está mais perto da entrada permanecendo dentro do conjunto de segunda a sexta, tratando sábado e domingo como não úteis que devem ser reatribuídos.
A distância é medida em meias-noites de calendário inteiras na linha temporal gregoriana proléptica, interpretada como string de data UTC sem hora do dia e sem conversão de fuso horário local. Para qualquer segunda a sexta o deslocamento é zero e result é igual à entrada normalizada. Casos rejeitados incluem o campo date ausente, formatos incorretos como 2024/03/16, meses impossíveis e dias que não existem como 2023-02-29.
Se você precisar de um dia da semana com nome em ou após uma base, dias úteis com feriados ou contagens de fim de semana entre dois carimbos, use essas ferramentas dedicadas; esta página responde apenas o ajuste seg–sex mais próximo para uma data ISO explícita.
Onde a aritmética do dia útil mais próximo se encaixa em operações, folha e software
Equipes de operações e produto precisam de um dia útil mais próximo quando um corte deve cair num dia de calendário útil mesmo que o usuário tenha informado um carimbo de fim de semana, quando uma data de liquidação ou de aviso não deve ficar no sábado ou domingo, ou quando um acordo de nível de serviço define a entrega como o dia útil mais próximo em vez de uma regra unilateral de próximo ou anterior.
Fluxos de folha de pagamento e finanças encaixam datas de eventos de forma livre em buckets de seg–sex para que jobs em lote, janelas ACH e vencimentos de fatura fiquem fora do fim de semana sem inventar um calendário completo de feriados por país. Analistas que constroem rótulos de coorte usam o mesmo movimento para alinhar inícios de observação longe do ruído de fim de semana mantendo dias úteis exatos, evitando erros de desvio de um nos limites de ano e em dias bissextos.
Desenvolvedores chamam o contrato a partir de scripts para gerar vetores de teste determinísticos para agendadores e validadores de formulário, para semear calendários de demonstração em fluxos de onboarding, ou para satisfazer requisitos de produto que exigem um passo de calendário puro sem inícios de semana do locale do host.
Educadores e redatores de normas usam a ferramenta para demonstrar que 2024-03-16 é um sábado cujo dia útil mais próximo é sexta-feira e que o domingo se mapeia para frente à segunda-feira, sem depender de números seriais de planilha que diferem entre produtos nem de objetos Date ao vivo que mudam com fusos horários.
Combine-a com ajudantes de próximo dia da semana, soma de dias úteis ou contagem de fins de semana quando precisar de passos de calendário relacionados, e com outras ferramentas determinísticas gratuitas ao montar um pequeno laboratório de utilitários de data.
Casos de uso
Ajustes de corte e liquidação
Mova cortes, carimbos de liquidação e datas de aviso informados no fim de semana para o dia de segunda a sexta mais próximo, sem inventar uma política unilateral de próximo dia útil.
Alinhamento de folha e jobs em lote
Normalize datas de eventos de forma livre em buckets de seg–sex para janelas ACH, vencimentos de fatura e calendários noturnos em lote que rejeitam sábado e domingo.
Perguntas frequentes
Esta ferramenta ignora feriados oficiais?
Não. Ela só distingue segunda–sexta de sábado–domingo. Use uma ferramenta de dias úteis com feriados se precisar de calendários por país.
Quais formatos de data são aceitos?
Datas de calendário ISO-8601 estendidas estritas YYYY-MM-DD. Comprimentos de mês e dias bissextos são validados; anos de 1 a 9999 são suportados. Apenas dia civil UTC — sem carimbos de tempo nem fusos horários.
Por que o sábado vai para sexta e não para segunda?
Porque a sexta está a um dia de distância e a segunda a dois. A ferramenta sempre escolhe o dia útil mais próximo: o sábado volta e o domingo avança.
Como os dias de fim de semana são ajustados?
O sábado passa para a sexta-feira anterior e o domingo para a segunda-feira seguinte. Qualquer data de segunda a sexta fica exatamente como está.
Para que serve achar o dia útil mais próximo?
Para quando um prazo, um pagamento ou um fechamento cai no fim de semana e a regra manda usar o dia útil mais próximo, como datas de folha de pagamento.
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
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/nearest-weekday \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-16"}'const res = await fetch("https://api.kit.forhosting.com/date/nearest-weekday", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-16"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/nearest-weekday",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-16"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/nearest-weekday", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-16"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-16"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/nearest-weekday", 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
{
"date": "2024-03-16"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.nearest_weekday",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
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
Use-a grátis no navegador para agendamento, cortes de folha de pagamento e alinhamento de SLA, ou chame a API a US$ 0,002 por solicitação bem-sucedida quando precisar de ajustes reproduzíveis de dia útil em CI, pipelines de relatórios ou recursos de produto.
O que significa o dia útil mais próximo e o que a resposta contém
Para o sábado, a sexta-feira anterior está a um dia e a segunda-feira seguinte a dois, logo o dia útil mais próximo é sexta-feira com offset_days igual a menos um. Para o domingo, a segunda-feira seguinte está a um dia e a sexta-feira anterior a dois, logo o dia útil mais próximo é segunda-feira com offset_days igual a mais um. A calculadora devolve a data base normalizada, a string result em ISO, offset_days, os indicadores booleanos is_weekend e shifted, o nome do dia da semana base e o número de dia da semana ISO (segunda igual a um até domingo igual a sete), o mesmo par para o resultado, os campos year, month e day do resultado, os componentes base para facilitar o encadeamento, e um breve lembrete da fórmula.
Como a data é lida e como o resultado permanece reproduzível
A string deve coincidir com quatro dígitos, um hífen, dois dígitos, outro hífen e dois dígitos; espaços no início ou no fim são removidos, mas datas parciais, dia do ano ordinal isolado, nomes de mês e carimbos com componente de hora não são expandidos aqui. Após o parse, o ano deve estar entre 1 e 9999, o mês entre 1 e 12, e o dia entre 1 e o comprimento real daquele mês naquele ano, com anos bissextos seguindo a regra gregoriana de divisível por quatro exceto séculos não divisíveis por quatrocentos. O campo preferido é date, mas os aliases iso_date, d, value, base e from são aceitos para que planilhas, query strings e formulários tipados reutilizem o mesmo contrato sem renomear colunas. Internamente, o motor obtém o dia da semana base com aritmética inteira pura de Sakamoto em escala domingo-zero, mapeia sábado para deslocamento de menos um e domingo para mais um, deixando segunda a sexta em zero, converte o triplo civil em contagem de dia serial gregoriano proléptico com o mapeamento conhecido days_from_civil, soma o deslocamento inteiro e recupera ano, mês e dia com civil_from_days. Combine a execução gratuita no navegador desta página com a API paga quando precisar do mesmo dia útil mais próximo dentro de um pipeline automatizado que não pode derivar por configurações de locale do host nem por transições de horário de verão.
Onde a aritmética do dia útil mais próximo se encaixa em operações, folha e software
Nesta página o trabalho roda inteiramente no seu navegador; pela API, cada consulta bem-sucedida custa US$ 0,002, validação falha não é cobrada e nada é armazenado após a resposta. Essa divisão — exploração interativa gratuita e uma API paga idêntica — combina com o restante do catálogo tier A do KIT e permite passar de uma verificação pontual a um pipeline sem mudar o resultado matemático.
Casos de integração
Fixtures de teste determinísticos
Gere strings ISO reproduzíveis do dia útil mais próximo para testes unitários, validadores de formulário e asserções de CI, sem depender de Date nem do relógio do host.
Perguntas técnicas
Quanto custa a calculadora do dia útil mais próximo de uma data?
É gratuita no seu navegador nesta página. Pela API, uma solicitação bem-sucedida custa US$ 0,002; entradas inválidas não são cobradas.
Como o sábado e o domingo são mapeados?
O sábado recua um dia para sexta-feira (offset_days = -1). O domingo avança um dia para segunda-feira (offset_days = +1). Esses são os dias seg–sex mais próximos numa semana simples de sete dias.
O que acontece se a entrada já for um dia útil?
A data base é devolvida inalterada. offset_days é 0, shifted é false e result é igual à data de entrada normalizada.