ForHosting KIT · Casa, cozinha e lazer

Dias até uma data

De 25 de julho de 2026 a 25 de dezembro de 2026 faltam 153 dias. Informe o dia de partida e a data que você espera e veja quantos dias de calendário completos ainda restam. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

De: 2026-07-25
Data: 2026-12-25

Você obtém

Dias: 153
Dias restantes: 153
Ano: 2.026
Mês: 12

Esta calculadora de dias até uma data responde a uma pergunta cotidiana de planejamento: a partir de um dia de referência escolhido, quantos dias inteiros de calendário faltam até uma data futura? Você envia dois dias de calendário ISO na forma ano-mês-dia — uma data from que faz as vezes de hoje e uma data-alvo para a qual está contando — e o mecanismo devolve a contagem não negativa de dias restantes. Pares do mesmo dia devolvem zero dias restantes.

O que significa dias até uma data futura

As pessoas digitam «dias até o Natal», «dias até o meu casamento» ou «quantos dias faltam até o prazo» quando já conhecem o dia de calendário alvo e só querem a contagem de dias inteiros restantes. Essa busca não é a mesma que perguntar quantos dias há entre duas datas arbitrárias em qualquer direção, nem a mesma que perguntar quantos dias restam até o trinta e um de dezembro.

Esta página trata o alvo como um horizonte futuro: os dias restantes equivalem ao número de dia serial gregoriano do alvo menos o número de dia serial da referência. Se a subtração é negativa, o alvo está no passado em relação à referência e a capacidade recusa o par. Se a subtração é zero, o acontecimento é o mesmo dia de calendário e a contagem restante é zero.

Horários do dia, fusos horários e calendários de dias úteis ficam fora do escopo: a unidade é o dia civil de meia-noite a meia-noite.

Como as duas datas ISO são lidas e o que volta

Os campos obrigatórios são date, o alvo futuro na forma YYYY-MM-DD, e from, o dia de calendário de referência que faz as vezes de hoje. Cada valor deve ser um dia gregoriano real: ano de quatro dígitos, mês de dois dígitos, dia de dois dígitos, com vinte e nove de fevereiro permitido só em ano bissexto. Os anos se limitam ao intervalo inclusivo de um a nove mil novecentos e noventa e nove para que as cadeias ISO de quatro dígitos fiquem bem definidas.

Um alvo anterior a from falha com uma mensagem de que a data está no passado.

Checagens clássicas incluem dois mil e vinte e seis hífen zero sete hífen vinte e cinco até o Natal dois mil e vinte e seis hífen um dois hífen vinte e cinco, que produz cento e cinquenta e três dias restantes, e dois mil e vinte e quatro hífen zero dois hífen vinte e oito até dois mil e vinte e quatro hífen zero três hífen zero um, que produz dois dias atravessando um dia bissexto.

Onde uma contagem regressiva de dias até uma data aparece no trabalho real

Quem planeja casamentos e festas usa uma cifra de dias restantes quando um cartão, uma faixa do site ou um convite pronto para impressão precisa de um único número que não vire se o fuso do visitante fica a oeste da cidade do evento. Docentes passam lição de casa de contagem regressiva para que o alunado confira pares de fevereiro bissexto e cruzamentos de ano sem abrir uma planilha que use em silêncio a meia-noite local.

Domicílios que contam até uma mudança, uma consulta de visto ou o início de um trimestre escolar querem uma recusa clara quando alguém digita por engano a data do ano passado, em vez de um negativo com sinal que parece uma contagem regressiva. Nada é armazenado depois de devolver a resposta.

Combine este destino com uma ferramenta de dias entre datas quando precisar de um intervalo com sinal nos dois sentidos, com uma de dias restantes no ano quando o horizonte for sempre o trinta e um de dezembro, ou com uma de contagem entre datas quando também precisar de horas e minutos sobrando. Reserve esta página para a busca única «quantos dias faltam até esta data futura».

Casos de uso

Contagens regressivas de festas e casamentos

Transforme um dia de referência e o dia de um evento futuro em uma única contagem de dias restantes para cartões, faixas e convites, sem deriva de fuso.

Checagens escolares de bissexto e virada de ano

Deixe o alunado verificar contagens regressivas de dias inteiros pelo vinte e nove de fevereiro e o Ano-Novo sem uma planilha que use a meia-noite local.

Perguntas frequentes

Como se calculam os dias até uma data futura?

days = serial(date) − serial(from) no calendário gregoriano. Envie duas datas ISO YYYY-MM-DD. O mesmo dia devolve 0. Um alvo anterior a from é recusado por estar no passado.

O que acontece se a data-alvo já passou?

Este destino é uma contagem regressiva até uma data futura, não um intervalo com sinal nas duas direções.

Um dia bissexto muda a contagem restante?

Sim. 29 de fevereiro é contado quando cai estritamente entre from e date. De 2024-02-28 até 2024-03-01 são dois dias; o mesmo par em 2023 é inválido se você escrever 2023-02-29.

O fuso horário ou a hora do dia mudam o resultado?

Não. A contagem usa dias de calendário inteiros, de meia-noite a meia-noite, então as mesmas duas datas dão o mesmo número de dias onde quer que você esteja.

O que aparece se a data-alvo for hoje?

O resultado é zero dias. Quando a data de partida e a data esperada são o mesmo dia do calendário, o evento já chegou e não resta nenhum dia.

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

POSThttps://api.kit.forhosting.com/life/days-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/life/days-until \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-12-25","from":"2026-07-25"}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2026-12-25","from":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/days-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

{
  "date": "2026-12-25",
  "from": "2026-07-25"
}

Exemplo de resposta

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

Limites

`year_min`	1
`year_max`	9999

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

Se o alvo fica antes do dia de referência, a solicitação falha com invalid_input em vez de um negativo com sinal, porque este destino é uma contagem regressiva, não um intervalo nos dois sentidos. Chamadas API bem-sucedidas custam US$ 0,002; validação com falha não é cobrada.

O que significa dias até uma data futura

A conversão serial segue a identidade days_from_civil de Howard Hinnant, que mapeia um triplo civil ano-mês-dia a uma contagem inteira de dias com uma convenção conhecida de época Unix, de modo que dias bissextos e regras de século permanecem coerentes entre os anos. Como a implementação nunca constrói um Date de JavaScript, o mesmo par produz sempre o mesmo inteiro, seja num Worker, num navegador em Tóquio ou num harness de testes com TZ fixado em America/New_York.

Como as duas datas ISO são lidas e o que volta

Aceitam-se os aliases until, target, to e end para o alvo; os aliases today, start, as_of e on para a referência, para que um formulário, uma cadeia de consulta ou uma coluna de planilha reutilizem o contrato. Campos ausentes, cadeias vazias, tipos que não são cadeia, padrões malformados, meses impossíveis e um vinte e nove de fevereiro fora de bissexto falham com invalid_input que nomeia o campo. Em caso de sucesso o corpo ecoa as cadeias canônicas date e from, os dias restantes e days_left (o mesmo inteiro não negativo), year, month e day do alvo, from_year, from_month e from_day da referência, um booleano same_day, uma cadeia formula e uma mensagem curta. Solicitações API bem-sucedidas custam US$ 0,002; entrada inválida não é faturada.

Onde uma contagem regressiva de dias até uma data aparece no trabalho real

Como esta capacidade é um motor parse puro, o trabalho corre por inteiro no seu navegador nesta página, e pela API cada consulta bem-sucedida custa US$ 0,002 enquanto a validação com falha não consome saldo.

Casos de integração

Widgets de lançamento e fixtures de integração

Fixe um inteiro determinista de dias restantes para interfaces de «dias até o lançamento» e testes que não devem depender do relógio do hospedeiro.

Perguntas técnicas

Por que devo enviar uma data from em vez de usar hoje automaticamente?

A calculadora nunca lê o relógio do hospedeiro, então os resultados permanecem idênticos em todos os fusos e nas provas golden. Use from como substituto de hoje.

Quanto custa a calculadora de dias até uma data?

É grátis 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.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa dias até uma data futura

Como as duas datas ISO são lidas e o que volta

Onde uma contagem regressiva de dias até uma data aparece no trabalho real

Casos de uso

Contagens regressivas de festas e casamentos

Checagens escolares de bissexto e virada de ano

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

O que significa dias até uma data futura

Como as duas datas ISO são lidas e o que volta

Onde uma contagem regressiva de dias até uma data aparece no trabalho real

Casos de integração

Widgets de lançamento e fixtures de integração

Perguntas técnicas

obrigado