Semanas até uma data futura
De 25 de julho a 10 de setembro de 2026 são 47 dias: 6 semanas inteiras e 5 dias, ou 6,714286 semanas em decimais. Você define as duas datas, então a contagem regressiva de um lançamento não muda com o passar dos dias. 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 de referência
- 2026-07-25
- Data-alvo
- 2026-09-10
- Total de dias
- 47
- Semanas completas
- 6
- Dias restantes
- 5
- Semanas fracionárias
- 6,714286
A calculadora de semanas até uma data mede a diferença exata em dias corridos entre uma data ISO de referência explícita e uma data-alvo posterior. Ela informa blocos completos de sete dias, os dias restantes e o mesmo intervalo em semanas decimais. Como você fornece as duas datas, o resultado nunca muda por causa do relógio atual, da localização do navegador, do horário de verão ou das configurações do servidor. A validação rigorosa também identifica datas impossíveis e alvos que não são posteriores à referência.
Informe duas datas de calendário ISO explícitas
Por exemplo, 2026-07-25 é aceito, enquanto 2026-7-25, July 25 2026 e textos que contenham horário são recusados. Exigir uma representação única e inequívoca impede que a ordem regional de dia e mês altere o resultado. A calculadora valida o calendário gregoriano proléptico real, além do padrão visível.
Assim, 29 de fevereiro é válido em 2024 e 2000, mas inválido em 2023 e 1900; 31 de abril é sempre inválido. São aceitos anos de 0001 a 9999. O alvo deve ser estritamente posterior à referência.
Nada é deduzido com base em hoje. Se você executar a mesma solicitação no próximo mês, receberá a mesma resposta, porque a referência faz parte da solicitação em vez de ser consultada em um relógio. Essa propriedade torna reproduzíveis cálculos salvos, registros de auditoria, testes e tarefas agendadas.
Ela também facilita a revisão do contrato de entrada: as duas datas exibidas na solicitação são a base completa do resultado, sem suposições ocultas de fuso horário, localidade ou data atual que possam influenciar a contagem.
Entenda semanas inteiras, dias restantes e semanas decimais
O cálculo não considera os dois extremos como dias completos. Passar de uma meia-noite à seguinte representa um dia; por isso, de uma segunda-feira até a segunda-feira seguinte são exatamente sete dias e uma semana. Fins de semana e feriados não são removidos.
Cada dia é um dia civil comum, adequado para contagens regressivas, marcos de projetos, janelas contratuais e outros cálculos de datas decorridas, não para calendários de dias úteis.
Por que o resultado é determinístico em UTC
Esta capacidade trata cada data fornecida como o limite da meia-noite civil em UTC, mas não cria objetos Date do JavaScript nem consulta o fuso horário do host. Em vez disso, valida o ano, o mês e o dia e transforma cada data gregoriana em um número inteiro de dia por meio de aritmética fixa. A subtração desses inteiros fornece o intervalo exato.
Esse método evita transições do horário de verão, que podem fazer uma subtração de relógios locais parecer uma hora mais curta ou mais longa, e evita regras de interpretação que variam entre ambientes de execução. O algoritmo não usa solicitações de rede, valores aleatórios, timestamps atuais nem analisadores sensíveis à localidade. A resposta repete as duas entradas ISO para que os registros posteriores sejam autoexplicativos.
Valores inválidos falham claramente em vez de serem normalizados em silêncio; uma data inexistente nunca é deslocada para o mês seguinte. Como a operação depende apenas de duas strings curtas e aritmética inteira de tempo constante, ela é adequada para verificações automatizadas repetidas sem introduzir desvio do relógio ou dependência da disponibilidade de serviços externos no fluxo.
Casos de uso
Planejar um marco fixo
Meça semanas completas e decimais desde uma data de planejamento aprovada até uma data posterior de entrega, lançamento ou publicação.
Criar contagens regressivas reproduzíveis
Armazene uma referência explícita junto ao alvo para regenerar relatórios sem que mudem conforme a data atual avança.
Comparar intervalos futuros
Use semanas decimais para comparar janelas contratuais, planos de estudo, campanhas ou fases de projetos em uma escala comum.
Perguntas frequentes
Como as semanas fracionárias são calculadas?
A diferença exata em dias corridos é dividida por sete e retornada com seis casas decimais. Semanas inteiras e dias restantes também são informados separadamente.
Quantas semanas há de 25 de julho a 10 de setembro de 2026?
São 47 dias, ou seja, 6 semanas inteiras e 5 dias, ou 6,714286 semanas em decimais. O número decimal descreve o intervalo todo; não é um pedaço de semana somado às 6.
A data-alvo pode ser igual ou anterior à data de referência?
Não. A data-alvo precisa ser estritamente posterior. Se as duas coincidirem ou o alvo já tiver passado, a ferramenta recusa, porque só responde quantas semanas faltam até um dia futuro.
A calculadora usa a data de hoje?
Não, nada é tirado do dia atual. Digite você mesmo a data de hoje como referência; como as duas datas ficam registradas, o mesmo cálculo dá o mesmo resultado sempre que for aberto de novo.
Fins de semana e feriados são descontados?
Não. Todos os dias do calendário contam, então de uma segunda-feira à segunda seguinte há exatamente sete dias e uma semana. Serve para contagens regressivas e prazos de contrato, não para dias úteis.
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/weeks-until-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"reference_date":"2026-07-25","target_date":"2026-09-10"}'const res = await fetch("https://api.kit.forhosting.com/date/weeks-until-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"reference_date": "2026-07-25",
"target_date": "2026-09-10"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/weeks-until-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"reference_date": "2026-07-25",
"target_date": "2026-09-10"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weeks-until-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"reference_date":"2026-07-25","target_date":"2026-09-10"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"reference_date":"2026-07-25","target_date":"2026-09-10"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weeks-until-date", 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-07-25",
"target_date": "2026-09-10"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.weeks_until_date",
"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
Informe duas datas de calendário ISO explícitas
Forneça reference_date e target_date no formato fixo YYYY-MM-DD, incluindo todos os zeros à esquerda. Datas iguais e alvos anteriores geram um erro invalid_input, pois esta capacidade responde a uma pergunta propositalmente específica: quantas semanas faltam desde uma data inicial conhecida até uma data futura conhecida.
Entenda semanas inteiras, dias restantes e semanas decimais
O resultado começa com total_days, a quantidade de intervalos de meia-noite a meia-noite entre a referência e o alvo. whole_weeks é o quociente inteiro da divisão desse total por sete, e remaining_days é o resto entre zero e seis. fractional_weeks expressa o intervalo completo em semanas, dividindo total_days por sete e arredondando o número JSON exibido para seis casas decimais. Portanto, um intervalo de 47 dias contém 6 semanas inteiras, 5 dias restantes e 6.714286 semanas fracionárias. Esses campos descrevem a mesma duração de maneiras complementares; fractional_weeks não é uma semana parcial adicional a ser somada a whole_weeks. Use whole_weeks quando apenas blocos completos de sete dias forem relevantes, remaining_days quando um cronograma precisar dos dias corridos residuais e fractional_weeks em estimativas, gráficos, taxas ou comparações que aceitem decimais.
Por que o resultado é determinístico em UTC
Entradas idênticas, portanto, produzem o mesmo JSON em um navegador, worker de borda, conjunto de testes ou repetição futura. Isso é especialmente importante quando a contagem comprova um prazo, alimenta uma planilha ou participa de um caso de regressão. Você pode testar o cálculo gratuitamente no navegador, enquanto cada item bem-sucedido da API usa o preço-base publicado de US$ 0,002.
Perguntas técnicas
A calculadora usa a data de hoje?
Não. Você precisa fornecer reference_date e target_date, portanto o cálculo nunca depende do relógio atual.
A data-alvo precisa ser posterior?
Sim. Datas iguais e alvos anteriores à referência são recusados com invalid_input, pois esta capacidade mede o tempo até um alvo futuro.
O horário de verão pode mudar a resposta?
Não. O algoritmo usa aritmética gregoriana de dias inteiros com semântica UTC e nunca utiliza horários locais nem o objeto Date do JavaScript.
Quanto custa um cálculo pela API?
Cada item bem-sucedido usa o preço-base publicado de US$ 0,002. A calculadora no navegador está disponível sem cobrança de API.