Stimi la fase lunare per qualsiasi data
Questo strumento trasforma una data di calendario in una descrizione pratica del ciclo lunare, come luna nuova, falce crescente, primo quarto, luna piena o fase calante.
Esegui gratis nel browser
Riporta inoltre l’età lunare approssimativa, la percentuale illuminata e la frazione del ciclo. Il calcolo è deterministico e usa un mese sinodico medio misurato da una luna nuova di riferimento nota. Non richiede posizione geografica, rete, servizi astronomici né conservazione dei dati dell’utente, quindi è adatto a pianificazioni rapide e procedure software ripetibili.
Inserisca una data gregoriana completa
Indichi la data esattamente nel formato AAAA-MM-GG, compresi gli zeri iniziali per mesi e giorni di una sola cifra. Per esempio, l’8 aprile 2024 si scrive 2024-04-08. Lo strumento convalida il calendario gregoriano effettivo, non soltanto la forma del testo, e quindi rifiuta valori impossibili come il 30 febbraio. Gli anni bisestili seguono la regola della divisibilità per quattro, con l’eccezione dei secoli e la correzione dei quattrocento anni. Il calcolo considera la data richiesta a mezzogiorno nel tempo universale coordinato. In questo modo ogni giorno ha un punto di valutazione uniforme e il risultato non dipende silenziosamente dal fuso orario del computer. Sono accettati gli anni da 0001 a 9999 nella rappresentazione a quattro cifre. Lo strumento non interpreta espressioni informali, ordinamenti regionali, timestamp o suffissi di fuso orario. Li converta prima nel formato documentato. Un ingresso rigoroso rende ripetibili le chiamate API e impedisce che una data ambigua come 03/04/2025 venga interpretata in modi diversi da sistemi differenti.
Comprenda come viene prodotta la stima
Il metodo parte da una luna nuova nota del 6 gennaio 2000 alle 18:14 UTC e converte la data richiesta in giorno giuliano. Calcola il tempo trascorso dal riferimento, quindi riporta il risultato entro un mese sinodico medio di 29.530588853 giorni. La posizione nell’intervallo ricorrente costituisce la frazione del ciclo, mentre la parte trascorsa viene restituita come età lunare in giorni. Otto etichette comuni suddividono il ciclo in fasce angolari uguali, centrate su luna nuova, primo quarto, luna piena e ultimo quarto. L’illuminazione viene stimata con una curva del coseno: parte vicino allo zero per cento durante la luna nuova, sale verso il cento per cento attorno alla luna piena e diminuisce nella metà calante. I valori sono arrotondati con una precisione stabile e utile. Questo è un modello aritmetico compatto, non un’effemeride. Poiché l’orbita reale varia, un’osservazione astronomica precisa può differire di parecchie ore e produrre l’etichetta adiacente vicino al confine tra due fasi.
Usi il risultato con la precisione appropriata
Utilizzi questa capacità quando una stima rapida e riproducibile conta più dell’orario preciso di un osservatorio. Un calendario può mostrare un’etichetta lunare riconoscibile accanto agli eventi, un progetto didattico può illustrare la ripetizione del ciclo e uno strumento di pianificazione può orientare una scelta approssimativa sulla luminosità notturna. Il campo della fase è pensato per una categoria leggibile. L’età e la frazione del ciclo sono più adatte a ordinare, creare indicatori visivi o confrontare date vicine, mentre illumination_percent offre una stima intuitiva della luminosità. Poiché l’algoritmo riceve soltanto la data, non calcola sorgere, tramontare, altezza, azimut, eclissi, visibilità locale, meteo o orientamento apparente della parte illuminata. Tali domande richiedono coordinate geografiche, ora esatta e dati orbitali più dettagliati. Non usi la stima per navigazione, sicurezza, pubblicazioni scientifiche, decisioni religiose che richiedono un’osservazione autorizzata o eventi legati all’istante esatto della fase. Per consultazioni comuni ed elementi grafici delle applicazioni, è trasparente, economica e identica a ogni esecuzione. Nel browser non serve una chiamata al server; ogni richiesta API automatizzata costa $0.002.
Casi d'uso
Aggiungere la fase a un calendario
Mostri una fase approssimativa accanto agli eventi senza interrogare un servizio astronomico esterno.
Preparare fotografie notturne informali
Confronti le date in base all’illuminazione stimata prima di verificare orari locali e meteo.
Spiegare il ciclo lunare
Generi esempi ripetibili delle fasi crescente, piena e calante per lezioni o dimostrazioni.
Domande frequenti
Quanto è precisa la stima?
È adatta ai calendari generici. Poiché usa un mese lunare medio e non effemeridi complete, gli istanti esatti possono differire di parecchie ore.
Quale ora del giorno viene usata?
Il calcolo valuta la data indicata alle 12:00 UTC, così non dipende mai dal fuso orario locale.
Calcola il sorgere o il tramontare della Luna?
No. Questi orari richiedono una posizione geografica e un modello astronomico più dettagliato.
Quale formato di data è accettato?
Usi esattamente AAAA-MM-GG con mese e giorno gregoriani validi, per esempio 2024-04-08.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. La versione nel browser può essere eseguita localmente senza chiamare l’API.
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
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/misc2/moon-phase-estimate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-04-08"}'const res = await fetch("https://api.kit.forhosting.com/misc2/moon-phase-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-04-08"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/misc2/moon-phase-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-04-08"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/misc2/moon-phase-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-04-08"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-04-08"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/moon-phase-estimate", 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": "2024-04-08"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "misc2.moon_phase_estimate",
"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
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. |