ForHosting KIT · Strumenti per sviluppatori

Calcolo della data della prossima luna piena

Il calcolatore stima la prima luna piena successiva alla data indicata da Lei. Usa una luna nuova di riferimento fissa e il mese sinodico medio, esegue tutta l’aritmetica del calendario in UTC e non consulta mai l’orologio corrente.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il risultato è quindi riproducibile su server, browser, dispositivi e fusi orari. È utile quando una stima stabile conta più della precisione di un osservatorio. Poiché l’orbita lunare reale varia, consideri il giorno restituito un’approssimazione, non l’orario ufficiale di un evento astronomico.

Che cosa indica la data restituita

Inserisca una data gregoriana nel formato rigoroso YYYY-MM-DD. Il calcolatore la interpreta come mezzanotte UTC all’inizio del giorno e trova il primo istante di luna piena modellato successivo. La risposta riporta la data UTC che contiene tale istante. “Prossima” ha quindi un significato preciso: se l’evento modellato avviene più tardi nel giorno inserito, può essere restituita la stessa data; un evento esattamente sul limite non vale. Il risultato è un riferimento stabile per il calendario, non garantisce che la Luna appaia perfettamente piena a ogni osservatore nella data civile locale. Non calcola sorgere della Luna, visibilità, meteo, altitudine o illuminazione. Per un orario esatto, consulti effemeridi professionali.

Come funziona il modello a ciclo medio

L’algoritmo parte dalla luna nuova di riferimento del 2000-01-06 18:14 UTC e da un mese sinodico medio di 29.530588853 giorni. Metà periodo definisce la luna piena di riferimento. La data gregoriana viene convertita in un conteggio intero di giorni con le regole aritmetiche per anni bisestili e lunghezze dei mesi, senza l’oggetto Date di JavaScript. Si determina poi quanti periodi completi servono per raggiungere il primo istante dopo il limite e si riconverte il risultato in data gregoriana. Costanti e regole fisse garantiscono la stessa uscita per la stessa entrata. Le lunazioni reali variano, quindi il risultato può differire da un almanacco astronomico autorevole, soprattutto vicino al cambio di giorno UTC.

Convalida, automazione e uso appropriato

L’entrata deve essere una data reale con anno di quattro cifre da 0001 a 9999, mese e giorno di due cifre. Date impossibili come il 30 febbraio vengono rifiutate, non normalizzate. Il calcolo non usa rete, impostazioni locali, data corrente, stato memorizzato o casualità. Processi batch, browser e test possono così riprodurre esattamente la risposta. L’uscita indica anche modello, durata del ciclo ed epoca di riferimento. Per l’automazione via API, il prezzo base per richiesta è $0.002. Non usi lo strumento per operazioni spaziali, navigazione, osservazioni scientifiche, scadenze legali legate a calendari lunari ufficiali o decisioni religiose basate sull’avvistamento locale; consulti l’autorità competente.

Casi d'uso

Aggiungere un riferimento approssimativo

Inserisca in un calendario o piano editoriale la prossima luna piena modellata dopo un evento.

Creare dati di test deterministici

Generi risultati lunari stabili senza dipendere da orologio, fuso orario o effemeridi esterne.

Spiegare modelli periodici di date

Mostri come un’epoca di riferimento e un ciclo medio ripetuto si proiettano sulle date gregoriane.

Domande frequenti

Quanto è precisa la data?

È una stima a ciclo medio e può differire da effemeridi autorevoli, specialmente vicino al limite di un giorno UTC.

Che cosa significa dopo la data inserita?

L’entrata è la mezzanotte UTC a inizio giornata; viene scelto il primo istante modellato strettamente successivo.

Il calcolo usa il mio fuso orario?

No. Limite di entrata e data restituita sono definiti in UTC per un risultato deterministico.

Usa la data corrente o un servizio astronomico in diretta?

No. Usa soltanto l’entrata esplicita, costanti fisse e aritmetica del calendario gregoriano.

Quanto costa una richiesta API?

Il prezzo base è $0.002 per richiesta. Nel browser può essere eseguito lo stesso calcolo puro.

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-full-moon

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-full-moon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

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

import os, requests

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

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

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

Esempio di risposta

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