ForHosting KIT · Ferramentas para dev

Calculadora de fins de semana até uma data

A calculadora de fins de semana até uma data conta pares completos de sábado e domingo no intervalo inclusivo entre uma data de referência e uma data-alvo.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Assim, você recebe uma resposta prática sem misturar fins de semana parciais. Informe duas datas do calendário gregoriano no formato YYYY-MM-DD; a ferramenta aceita alvos passados ou futuros, mostra a direção, informa o período inclusivo e entrega um resultado reproduzível.

O que é considerado um fim de semana completo

Esta calculadora considera como fim de semana o sábado e o domingo consecutivos da semana de trabalho comum, de segunda a sexta-feira. O par só entra na contagem quando as duas datas estão dentro do intervalo inclusivo formado pela referência e pelo alvo. Por exemplo, um período que termina no sábado não inclui aquele fim de semana, pois o domingo fica de fora. Um período iniciado no domingo também exclui o par anterior. Já um intervalo que começa no sábado e termina no domingo contém exatamente um fim de semana completo. Essa regra evita apresentar um descanso parcial como dois dias inteiros disponíveis. Sextas-feiras, feriados, datas comemorativas locais e outras convenções regionais não entram na conta. Os dois limites são incluídos na verificação. Portanto, o resultado responde de forma precisa quantos pares completos de sábado e domingo estão inteiramente contidos entre as datas informadas.

Como informar as datas e interpretar o resultado

Informe a data de referência e a data-alvo no formato estrito YYYY-MM-DD, com quatro dígitos para o ano e dois para o mês e o dia. A calculadora valida datas reais do calendário gregoriano; por isso, valores impossíveis como 30 de fevereiro são rejeitados, em vez de serem deslocados silenciosamente para outro mês. O alvo pode ser posterior, anterior ou igual à referência. A contagem de fins de semana completos é simétrica: inverter os mesmos limites não altera o total. O campo de direção indica se o alvo está no futuro, no passado ou no mesmo dia em relação à referência fornecida. O total inclusivo de dias corridos também é exibido para facilitar a conferência. A data atual não é presumida. Para fazer uma contagem a partir de hoje, informe explicitamente a data de hoje como referência; assim, uma solicitação salva continuará clara e reproduzível no futuro.

Como usar a contagem em planos reais

A quantidade de fins de semana completos é uma medida prática, mas deve ser combinada com as limitações de cada atividade. Em uma viagem, cada par contado representa um sábado e um domingo inteiramente dentro do período; deslocamentos na sexta-feira à noite ou na segunda-feira de manhã ficam fora dessa medida. Em um projeto, o número pode estimar quantas sessões contínuas de trabalho ou períodos de descanso existirão antes de um marco, mas não os transforma em horas úteis. Para eventos, ele ajuda a comparar opções de datas com o mesmo critério quando uma delas começa ou termina no meio de um fim de semana. O algoritmo usa somente valores de calendário, sem fuso horário, horas, horário de verão, rede ou data atual do dispositivo. Por isso, a mesma entrada gera o mesmo resultado no navegador e pela API. Cada chamada de API custa US$ 0,002, enquanto a calculadora do navegador executa localmente a mesma lógica determinística.

Casos de uso

Planejar o período de uma viagem

Veja quantos pares completos de sábado e domingo cabem entre as datas de reserva, partida ou retorno.

Estimar fins de semana de um projeto

Conte os fins de semana completos disponíveis antes de um lançamento, entrega, reforma ou prova.

Comparar períodos para eventos

Avalie opções de datas sem considerar por engano um sábado ou domingo no limite como um fim de semana completo.

Perguntas frequentes

As datas de referência e alvo são incluídas?

Sim. Os dois limites fazem parte do intervalo, mas o fim de semana só conta quando sábado e domingo estão incluídos.

O que acontece se a data-alvo for anterior?

A calculadora usa o mesmo período e marca a direção como passada. Inverter os limites não altera a contagem.

Um período que termina no sábado conta esse fim de semana?

Não. O domingo seguinte fica fora do intervalo, portanto esse par não é um fim de semana completo.

Feriados ou costumes regionais entram na conta?

Não. Um fim de semana significa estritamente sábado e domingo; feriados e outros dias regionais de folga não são considerados.

O fuso horário ou o horário de verão altera o resultado?

Não. O cálculo usa apenas datas do calendário, sem horas, fusos horários ou mudanças de horário de verão.

Quanto custa uma solicitação pela API?

Cada solicitação pela API custa US$ 0,002. A versão no navegador executa gratuitamente o mesmo cálculo determinístico.

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/weekends-until

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/weekends-until \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference_date":"2026-08-12","target_date":"2026-09-07"}'

const res = await fetch("https://api.kit.forhosting.com/date/weekends-until", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "reference_date": "2026-08-12",
    "target_date": "2026-09-07"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekends-until",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "reference_date": "2026-08-12",
    "target_date": "2026-09-07"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weekends-until", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"reference_date":"2026-08-12","target_date":"2026-09-07"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"reference_date":"2026-08-12","target_date":"2026-09-07"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekends-until", 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

{
  "reference_date": "2026-08-12",
  "target_date": "2026-09-07"
}

Exemplo de resposta

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

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.

Ver a documentação completa do KIT →