Calculadora de dias até o Dia dos Namorados
A calculadora de dias até o Dia dos Namorados informa quantos dias corridos faltam para 14 de fevereiro a partir da data fornecida.
Executar grátis
Informe uma data gregoriana válida no formato YYYY-MM-DD para receber uma contagem exata. O cálculo considera anos bissextos, retorna zero quando a data já é o Dia dos Namorados e avança automaticamente para o ano seguinte quando 14 de fevereiro já passou. É útil para planos pessoais, calendários editoriais, campanhas comerciais, preparação de eventos e qualquer fluxo que exija uma contagem regressiva estável, sem depender do relógio atual nem de um fuso horário específico.
Informe a data inicial da contagem regressiva
Forneça uma data do calendário gregoriano no formato exato YYYY-MM-DD, como 2026-02-01. O ano aparece primeiro, seguido pelo mês e pelo dia com dois algarismos. Essa estrutura rigorosa evita ambiguidades: 03-04 pode significar 4 de março ou 3 de abril em regiões diferentes, enquanto 2026-03-04 tem apenas um significado. A calculadora valida a data inteira, e não somente sua aparência. Valores impossíveis, como 30 de fevereiro, mês 13, dia zero e 29 de fevereiro em um ano não bissexto, são rejeitados. Os anos começam em 0001, e texto adicional, horários ou formatos abreviados não são aceitos. Essa precisão torna o resultado apropriado tanto para automações quanto para uma consulta rápida. Escolha a data em que o planejamento começa, não necessariamente o dia em que você envia a solicitação. Como o valor informado é a única referência temporal, a mesma entrada sempre gera o mesmo resultado, independentemente do relógio do servidor, do fuso do navegador, do horário de verão ou da localização.
Entenda como o próximo Dia dos Namorados é escolhido
O Dia dos Namorados é tratado como 14 de fevereiro no calendário gregoriano. Se a data informada vier antes desse dia, o destino será 14 de fevereiro do mesmo ano. Se for exatamente 14 de fevereiro, a contagem retornada será zero, pois não resta nenhum dia corrido até a ocasião. Se a data vier depois, a calculadora selecionará 14 de fevereiro do ano seguinte. Essa convenção mantém o resultado entre zero e 365 dias e corresponde ao sentido comum de uma contagem regressiva anual. O cálculo converte as duas datas em posições inteiras numa linha do tempo gregoriana proléptica e faz a subtração. As regras de ano bissexto são aplicadas com precisão: anos divisíveis por quatro são bissextos, exceto os anos de século que não sejam também divisíveis por 400. Assim, um 29 de fevereiro entre a origem e o destino acrescenta corretamente um dia. Horários não participam do cálculo, portanto um dia mais curto ou longo devido ao horário de verão não modifica a resposta. O resultado conta mudanças de data, não períodos parciais de vinte e quatro horas.
Use a contagem em planos e fluxos automatizados
A resposta contém um único campo, days_until_valentines_day, cujo valor inteiro pode alimentar um indicador, uma regra de lembrete, um calendário editorial, um plano de estoque ou o cronograma de uma campanha. Uma loja pode alterar sua mensagem quando a contagem entrar numa faixa definida; uma equipe de eventos pode marcar conferências a 90, 30, 14 e 7 dias; e uma publicação pode gerar uma contagem diária sem repetir a lógica de calendário em cada canal. A capacidade não usa automaticamente a data atual, pois isso faria solicitações idênticas mudarem com o tempo e criaria divergências entre fusos. Para uma contagem ao vivo, forneça a data de hoje por meio de um relógio confiável; para testar um fluxo, use qualquer data passada ou futura. O cálculo é determinístico e não utiliza rede, estado armazenado, valores aleatórios nem o objeto Date do ambiente. Isso facilita armazenar resultados por entrada e testar limites. Datas inválidas retornam um erro de entrada tipado, em vez de um número aparentemente plausível, permitindo que a integração pare, corrija o dado de origem e tente novamente sem publicar uma contagem enganosa.
Casos de uso
Planejar uma campanha do Dia dos Namorados
Converta a data inicial em uma contagem precisa para lançamentos, revisões criativas e alterações promocionais.
Criar um lembrete anual
Use o inteiro retornado para acionar lembretes em intervalos escolhidos antes de 14 de fevereiro de cada ano.
Testar experiências sensíveis à data
Forneça datas fixas próximas de 14 de fevereiro e anos bissextos para verificar contadores sem alterar o relógio do sistema.
Perguntas frequentes
O que acontece quando a data é 14 de fevereiro?
O resultado é zero porque a data informada já é o Dia dos Namorados.
O que acontece depois de 14 de fevereiro?
A calculadora usa 14 de fevereiro do ano seguinte como destino.
O cálculo considera anos bissextos?
Sim. Ele aplica as regras gregorianas, inclusive as exceções de século e dos anos divisíveis por 400.
Qual formato de data é aceito?
Use exatamente YYYY-MM-DD com ano, mês e dia válidos, por exemplo, 2026-02-01.
O fuso horário ou o horário de verão afeta a resposta?
Não. O cálculo usa datas do calendário e aritmética inteira, não horários nem fusos.
Quanto custa uma solicitação de API?
Cada solicitação de API custa US$ 0,002. A versão no navegador pode ser executada localmente sem chamada de rede.
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/days-until-valentines-day \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-02-01"}'const res = await fetch("https://api.kit.forhosting.com/date/days-until-valentines-day", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-02-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/days-until-valentines-day",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-02-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/days-until-valentines-day", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-02-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-02-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-until-valentines-day", 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-02-01"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.days_until_valentines_day",
"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. |