ForHosting KIT · Strumenti per sviluppatori

Conto alla rovescia per il prossimo compleanno

Questo calcolatore individua il prossimo compleanno partendo da una data di nascita e da una data di riferimento esplicite.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Restituisce la data del compleanno, il numero esatto di giorni di calendario rimanenti, l'età che verrà raggiunta e l'indicazione se l'evento cade nell'anno di riferimento. Il calcolo gestisce il cambio d'anno e gli anni bisestili senza leggere l'orologio, usare un fuso orario o contattare servizi esterni. Gli stessi dati producono quindi sempre una risposta identica e verificabile.

Inserisca due date complete

Indichi birth_date e reference_date nel formato non ambiguo YYYY-MM-DD, compresi gli zeri iniziali. La nascita fornisce mese e giorno ricorrenti e l'anno necessario per calcolare l'età. Il riferimento stabilisce l'inizio del conto e non può precedere la nascita. Entrambi i valori vengono convalidati come vere date gregoriane; date impossibili, parziali o ambigue sono rifiutate anziché corrette. Poiché è Lei a fornire il riferimento, lo strumento è adatto a verifiche storiche, test e pianificazioni future senza dipendere dall'orologio del dispositivo. Se il riferimento coincide con il compleanno, days_remaining vale zero e viene restituita la stessa data. Il compleanno resta così quello prossimo per tutta la giornata civile, senza passare prematuramente all'anno seguente.

Comprenda il cambio d'anno e i risultati

Il calcolatore costruisce prima il compleanno nell'anno di riferimento. Se cade quel giorno o più tardi, lo seleziona e occurs_this_year vale true. Se è già trascorso, usa la data dell'anno successivo e l'indicatore vale false. Questo confronto gestisce ogni passaggio annuale. days_remaining è una differenza esatta fra date gregoriane, non fra orari locali; ora legale e scostamenti UTC non alterano il totale. next_birthday mantiene il formato YYYY-MM-DD, mentre turning_age mostra l'età raggiunta in quella data, non durante la consultazione. I campi consentono sia una visualizzazione chiara sia un obiettivo normalizzato. Ogni richiesta elabora una coppia di date tramite API per $0.002; il browser utilizza la medesima logica pura.

Applichi una regola coerente al 29 febbraio

Una nascita il 29 febbraio richiede una convenzione perché quel giorno manca nella maggior parte degli anni. Il calcolatore considera il 28 febbraio come compleanno osservato negli anni comuni e il 29 negli anni bisestili. La stessa regola governa confronto, selezione, giorni residui ed età. È una convenzione pratica per il conto alla rovescia, non un parere su maggiore età, prestazioni, contratti o preferenze personali. Leggi e consuetudini possono scegliere il 28 febbraio, il 1° marzo o un'altra definizione. Per una scadenza ufficiale, Lei deve applicare la norma competente. Sono supportati gli anni da 0001 a 9999. Un riferimento alla fine del 9999 può essere rifiutato se il compleanno successivo richiedesse l'anno 10000, non rappresentabile nel formato previsto.

Casi d'uso

Creare un promemoria

Trasformi nascita e data di esecuzione in un conto preciso e in una destinazione normalizzata.

Organizzare la festa

Verifichi se il compleanno deve ancora arrivare quest'anno o passa a quello seguente.

Collaudare software di date

Produca risultati ripetibili per il giorno stesso, i cambi d'anno e i casi bisestili senza orologio di sistema.

Domande frequenti

Un compleanno oggi restituisce zero?

Sì. Restituisce zero giorni e usa la data di riferimento come prossimo compleanno.

Cosa accade se il compleanno è già passato?

Viene scelta la data dell'anno seguente e occurs_this_year restituisce false.

Come viene gestito il 29 febbraio in un anno comune?

Viene usato il 28 febbraio come compleanno osservato quando il 29 non esiste.

Il fuso orario può cambiare il conteggio?

No. Il calcolo usa aritmetica gregoriana intera e non crea orari.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico funziona anche nel browser.

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/next-birthday-countdown

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/next-birthday-countdown \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"1990-10-20","reference_date":"2026-08-12"}'

const res = await fetch("https://api.kit.forhosting.com/date/next-birthday-countdown", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "birth_date": "1990-10-20",
    "reference_date": "2026-08-12"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/next-birthday-countdown",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "birth_date": "1990-10-20",
    "reference_date": "2026-08-12"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/next-birthday-countdown", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"birth_date":"1990-10-20","reference_date":"2026-08-12"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"birth_date":"1990-10-20","reference_date":"2026-08-12"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/next-birthday-countdown", 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

{
  "birth_date": "1990-10-20",
  "reference_date": "2026-08-12"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.next_birthday_countdown",
  "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 →