ForHosting KIT · Strumenti per sviluppatori

Calcolo dei giorni mancanti a San Valentino

Il calcolatore dei giorni mancanti a San Valentino indica quanti giorni di calendario separano la data fornita dal 14 febbraio.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca una data gregoriana valida nel formato YYYY-MM-DD per ricevere un conteggio esatto. Il calcolo considera gli anni bisestili, restituisce zero se la data è già San Valentino e passa automaticamente all’anno successivo quando il 14 febbraio è trascorso. È utile per progetti personali, calendari editoriali, campagne commerciali, preparazione di eventi e qualsiasi flusso che richieda un conto alla rovescia stabile, indipendente dall’ora corrente e dal fuso orario.

Inserisca la data iniziale del conto alla rovescia

Fornisca una data del calendario gregoriano nell’esatto formato YYYY-MM-DD, per esempio 2026-02-01. Prima viene l’anno, seguito da mese e giorno a due cifre. Questa struttura rigorosa elimina le ambiguità: 03-04 può indicare il 4 marzo o il 3 aprile in regioni diverse, mentre 2026-03-04 ha un solo significato. Il calcolatore convalida l’intera data, non soltanto il suo aspetto. Rifiuta valori impossibili come il 30 febbraio, il mese 13, il giorno zero e il 29 febbraio in un anno non bisestile. Gli anni iniziano da 0001 e non sono ammessi testo aggiuntivo, orari o forme abbreviate. Tale precisione rende il risultato adatto sia all’automazione sia a una verifica rapida. Scelga la data da cui parte la pianificazione, non necessariamente quella in cui invia la richiesta. Poiché il valore fornito è l’unico riferimento temporale, lo stesso input produce sempre lo stesso risultato, a prescindere dall’orologio del server, dal fuso del browser, dall’ora legale o dalla posizione.

Comprenda come viene scelto il prossimo San Valentino

San Valentino corrisponde al 14 febbraio nel calendario gregoriano. Se la data inserita precede quel giorno, l’obiettivo è il 14 febbraio dello stesso anno. Se coincide con il 14 febbraio, il conteggio è zero perché non resta alcun giorno di calendario. Se è successiva, il calcolatore seleziona il 14 febbraio dell’anno seguente. Questa convenzione mantiene il risultato tra zero e 365 giorni e rispecchia il significato comune di un conto alla rovescia annuale. Il calcolo converte entrambe le date in posizioni intere su una cronologia gregoriana prolettica e le sottrae. Le regole degli anni bisestili sono applicate esattamente: sono bisestili gli anni divisibili per quattro, salvo quelli secolari non divisibili anche per 400. Un 29 febbraio compreso tra partenza e obiettivo aggiunge quindi il giorno corretto. Non sono coinvolti orari, perciò una giornata accorciata o allungata dall’ora legale non cambia la risposta. Si contano i passaggi di data, non frazioni di periodi di ventiquattro ore.

Usi il conteggio in piani e flussi automatici

La risposta contiene un solo campo, days_until_valentines_day, il cui intero può alimentare un indicatore, una regola di promemoria, un calendario editoriale, un piano scorte o la programmazione di una campagna. Un negozio può cambiare messaggio quando il conteggio entra in un intervallo; un team di eventi può fissare controlli a 90, 30, 14 e 7 giorni; una redazione può creare un aggiornamento quotidiano senza duplicare la logica del calendario in ogni canale. La capacità non usa automaticamente la data odierna, perché richieste identiche cambierebbero nel tempo e potrebbero divergere tra fusi. Per un conto alla rovescia dal vivo, fornisca la data di oggi da un orologio affidabile; per un test, usi qualsiasi data passata o futura. Il calcolo è deterministico e non utilizza rete, stato memorizzato, casualità o l’oggetto Date dell’ambiente. I risultati sono quindi memorizzabili per input e i casi limite facili da verificare. Una data non valida genera un errore di input tipizzato anziché un numero plausibile, così l’integrazione può fermarsi, correggere il dato e riprovare senza pubblicare un conteggio ingannevole.

Casi d'uso

Pianificare una campagna di San Valentino

Trasformi la data iniziale in un conteggio preciso per lanci, revisioni creative e modifiche promozionali.

Creare un promemoria annuale

Usi l’intero restituito per attivare promemoria a intervalli scelti prima del 14 febbraio di ogni anno.

Provare esperienze sensibili alla data

Fornisca date fisse vicine al 14 febbraio e anni bisestili per verificare gli indicatori senza cambiare l’orologio di sistema.

Domande frequenti

Che cosa accade se la data è il 14 febbraio?

Il risultato è zero perché la data inserita è già San Valentino.

Che cosa accade dopo il 14 febbraio?

Il calcolatore assume come obiettivo il 14 febbraio dell’anno seguente.

Il calcolo gestisce gli anni bisestili?

Sì. Applica le regole gregoriane, incluse le eccezioni dei secoli e degli anni divisibili per 400.

Quale formato di data è accettato?

Usi esattamente YYYY-MM-DD con anno, mese e giorno validi, per esempio 2026-02-01.

Il fuso orario o l’ora legale influiscono?

No. Il calcolo usa date di calendario e aritmetica intera, non orari o fusi.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. La versione per browser può essere eseguita localmente senza chiamate di rete.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/date/days-until-valentines-day

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

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)

Esempio di richiesta

{
  "date": "2026-02-01"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.days_until_valentines_day",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →