ForHosting KIT · Casa, cozinha e lazer

Contagem regressiva

De 25 de julho de 2026 até o Natal de 2026 faltam 153 dias. Informe a data de hoje e a do evento para ver os dias de calendário com sinal: positivos enquanto falta, zero no dia e negativos depois que passou. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Hoje
2026-07-25
Data do evento
2026-12-25
Você obtém
Dias
153
Status
upcoming

Uma contagem regressiva de calendário responde à pergunta de planejamento que as pessoas digitam de fato: quantos dias civis inteiros separam o hoje de um acontecimento-alvo no almanaque. Casamentos, provas, partidas de viagem, lançamentos de produto, fins de contrato e feriados públicos precisam desse inteiro, não de uma duração de relógio em horas e minutos nem de um aniversário de nascimento que se repete todo ano. Esta ferramenta nunca inventa o hoje com o relógio do servidor. O resultado é o número com sinal de dias gregorianos de hoje até o acontecimento: positivo se ele ainda está à frente, zero se é hoje e negativo se já passou.

O que uma contagem regressiva de calendário mede

Uma contagem regressiva de calendário é uma distância de dias inteiros com sinal de um hoje explícito até uma única data de acontecimento no calendário gregoriano proléptico. Não é um intervalo desordenado entre duas datas intercambiáveis, nem uma duração de relógio partida em horas minutos e segundos, nem um motor de aniversário que avança o mês e o dia de nascimento até o próximo aniversário.

Você indica um hoje civil e uma data civil de acontecimento; o motor converte cada terno em uma contagem serial de dias e subtrai, de modo que o Natal de dois mil e vinte e seis a partir de vinte e cinco de julho de dois mil e vinte e seis deixa cento e cinquenta e três dias restantes, o mesmo par invertido são cento e cinquenta e três dias no passado, e um acontecimento que cai no próprio hoje é zero.

Esse sinal é o contrato do produto: upcoming se o acontecimento ainda não chegou, today se as duas datas coincidem e past se ele já ocorreu. O mesmo par de datas civis produz sempre o mesmo inteiro porque o motor nunca consulta um relógio do hospedeiro, um fuso horário nem tabelas de horário de verão. Vinte e nove de fevereiro só é aceito em ano bissexto; um vinte e nove de fevereiro de ano comum não é forçado para março, é rejeitado.

Vizinhos do catálogo respondem a outras buscas: dias entre duas datas medem um intervalo absoluto, contagem entre duas datas devolve um resto de relógio e dias até o aniversário seguem um aniversário recorrente. Use esta página quando a busca e o formulário perguntarem quantos dias de calendário faltam para um acontecimento específico.

Onde uma contagem regressiva de calendário se justifica

Organizadores de casamento, candidatos a prova e agências de viagem precisam de uma única contagem de dias restantes diante de uma data de referência explícita, não de um resto de relógio nem de um aniversário de nascimento. Calendários de lançamento, mesas de contrato e murais de período letivo disparam um aviso quando o inteiro chega a trinta, sete, um ou zero. Sistemas de lembrete e de fidelidade agendam uma mensagem para a manhã do acontecimento sem embutir uma base de fusos em cada cliente.

Integração de recursos humanos, marketing de produto e murais municipais guardam a mesma contagem diante de uma data de auditoria para que exportações e suítes de regressão reproduzam o número sempre. Páginas para pais e quiosques de loja podem executar a contagem regressiva de calendário gratuita no navegador sem instalar uma biblioteca de datas.

Mantenha expectativas honestas: esta capacidade mede dias civis gregorianos de um hoje explícito até uma data de acontecimento; não pula fins de semana como dias úteis, não carrega calendários de feriados, não converte festas lunares, não define o hoje pelo relógio do servidor nem avança uma data de nascimento. Combine-a com uma ferramenta de dias entre datas quando a busca for um intervalo desordenado, com uma contagem de relógio quando horas e minutos importarem, e com um auxiliar de aniversário quando o acontecimento se repetir todo ano.

Como a implementação é parse pura de nível A, cada chamada bem-sucedida continua barata, determinística e livre de tokens de modelo ou rede de saída, exatamente o que suítes de regressão precisam ao fixar casos-limite de dia bissexto e de acontecimento-hoje ao longo de décadas de datas.

Contagens de casamento, prova e viagem

Informe o hoje e uma data de acontecimento para mostrar quantos dias civis faltam para um casamento, uma prova ou uma partida, em convites, planos de estudo e listas de mala.

Calendários de lançamento e de contrato

Fixe um lançamento de produto ou o fim de um contrato diante de uma data de planejamento fixa para que avisos e murais coincidam em cada reimpressão.

Pipelines de lembrete e marketing

Guarde a contagem com sinal diante de um hoje de auditoria para que as mensagens disparem na manhã do acontecimento sem deriva de relógio entre workers.

O que significa um valor negativo em days?

O acontecimento já ficou no passado em relação a today. Days positivo indica upcoming, zero indica que o acontecimento é hoje, e status rotula esse sinal.

Quanto custa a contagem regressiva de calendário?

A ferramenta do navegador é grátis no seu dispositivo.

Por que eu mesmo preciso digitar a data de hoje?

Porque a contagem regressiva nunca consulta um relógio ou fuso horário por conta própria. Você informa qual dia é hoje, então as mesmas duas datas dão sempre o mesmo número de dias, onde e quando você consultar.

A contagem regressiva inclui horas e minutos?

Não. Ela conta dias de calendário inteiros entre as duas datas, que é o que um casamento, uma prova ou uma viagem precisam. Um resto em horas, minutos e segundos é outro tipo de contagem.

O que aparece quando o evento é hoje?

Aparece zero dia e o evento é marcado como hoje. Na véspera aparece um dia restante, e no dia seguinte aparece um dia no passado, como número negativo.

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.

POSThttps://api.kit.forhosting.com/life/calendar-countdown

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/life/calendar-countdown \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_date":"2026-12-25","today":"2026-07-25"}'
{
  "event_date": "2026-12-25",
  "today": "2026-07-25"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.calendar_countdown",
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

year_min1
year_max9999
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Você informa o dia de referência e a data do acontecimento como valores civis YYYY-MM-DD, para que o mesmo par produza sempre a mesma contagem no navegador, na integração contínua e na API. Uma data de destino vazia ou inválida falha com invalid_input e não é cobrada. Chamadas API bem-sucedidas usam o preço-base publicado US$ 0,002.

Contrato de entrada, validação de calendário e forma da resposta

Cada valor deve ser um dia civil no formato YYYY-MM-DD, por exemplo dois mil e vinte e seis hífen um dois hífen dois cinco para um Natal e dois mil e vinte e seis hífen zero sete hífen dois cinco para o dia de referência. Os anos vão de um a nove mil novecentos e noventa e nove, os meses de um a doze, e o dia deve existir naquele mês sob regras gregorianas de ano bissexto, incluindo vinte e nove de fevereiro só em anos bissextos. A validação falha não é cobrada. Faça POST de um corpo JSON compacto com dois campos de texto obrigatórios: event_date e today. Os aliases opcionais target, target_date, date, until e to mapeiam para o campo do acontecimento; as_of, reference_date, reference, on e from mapeiam para today, para que construtores de formulários e SDKs conservem nomes habituais. Pares impossíveis como dois mil e vinte e três hífen zero dois hífen vinte e nove são rejeitados com invalid_input em vez de serem deslocados para março. Uma string vazia, um event_date ausente, um valor que não é texto ou uma forma errada como dois mil e vinte e seis barra doze barra vinte e cinco falham com uma mensagem que nomeia o campo. Se faltar today também é invalid_input, porque o motor nunca inventa um dia de referência com o relógio do hospedeiro.

Onde uma contagem regressiva de calendário se justifica

Chame a API pré-paga quando pipelines de notificação, gráficas ou ferramentas de sala precisarem de um contrato estável com saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo depois que o motor rejeita o pedido.

Como calcular uma contagem regressiva de calendário até um acontecimento?

Envie JSON com event_date e today em YYYY-MM-DD. O motor devolve days como contagem de dias civis com sinal, além de status e is_today.

Esta contagem regressiva usa o relógio do servidor para o hoje?

Não. today é obrigatório. O motor nunca lê o relógio do sistema, então os resultados coincidem em CI, navegadores e workers da API.

E se a data do acontecimento estiver vazia ou não for um dia real?

O pedido falha com invalid_input. Um event_date vazio, um campo ausente, 29 de fevereiro em ano comum e números de dia impossíveis são rejeitados.

Ver a documentação completa do KIT →