Estimez la phase lunaire pour une date
Cet estimateur transforme une date du calendrier en une description pratique du cycle lunaire : nouvelle lune, premier croissant, premier quartier, pleine lune ou phase décroissante.
Lancer gratuitement
Il indique aussi l’âge lunaire approximatif, le pourcentage éclairé et la fraction du cycle. Le calcul, entièrement déterministe, repose sur un mois synodique moyen mesuré depuis une nouvelle lune de référence connue. Il ne demande ni position géographique, ni accès réseau, ni service astronomique, ni conservation des données, ce qui convient aux planifications rapides et aux traitements logiciels reproductibles.
Saisissez une date grégorienne complète
Indiquez la date exactement au format AAAA-MM-JJ, avec un zéro initial pour les mois et les jours à un chiffre. Par exemple, le 8 avril 2024 s’écrit 2024-04-08. L’estimateur contrôle le véritable calendrier grégorien et pas seulement la forme du texte ; il refuse donc une valeur impossible comme le 30 février. Les années bissextiles suivent la règle de divisibilité par quatre, avec l’exception des siècles et la correction des quatre cents ans. Le calcul évalue la date demandée à midi en temps universel coordonné. Ce choix fournit un instant cohérent pour chaque journée et évite toute dépendance cachée au fuseau horaire de l’ordinateur. Les années 0001 à 9999 sont acceptées sous leur forme à quatre chiffres. Les expressions informelles, les ordres régionaux, les horodatages et les suffixes de fuseau ne sont pas interprétés. Convertissez-les au préalable dans le format documenté. Cette saisie stricte rend les appels répétables et empêche qu’une date ambiguë telle que 03/04/2025 soit comprise différemment selon le système.
Comprenez le calcul de l’estimation
La méthode part d’une nouvelle lune connue, survenue le 6 janvier 2000 à 18:14 UTC, puis convertit la date demandée en jour julien. Elle mesure la durée écoulée depuis cette référence et ramène le résultat dans un mois synodique moyen de 29.530588853 jours. La position dans cet intervalle répétitif constitue la fraction du cycle, tandis que la portion écoulée est présentée comme âge lunaire en jours. Huit libellés usuels découpent le cycle en secteurs angulaires égaux centrés sur la nouvelle lune, le premier quartier, la pleine lune et le dernier quartier. Une courbe cosinus estime l’éclairage : proche de zéro pour cent à la nouvelle lune, il monte vers cent pour cent autour de la pleine lune puis redescend pendant la moitié décroissante. Les valeurs sont arrondies de façon stable et pratique. Il s’agit d’un modèle arithmétique compact, non d’éphémérides. L’orbite réelle variant, une observation astronomique précise peut différer de plusieurs heures et donner le libellé voisin près d’une transition.
Employez le résultat avec la bonne précision
Utilisez cette capacité lorsqu’une estimation rapide et reproductible compte davantage qu’un horaire d’observatoire. Un calendrier peut afficher un libellé lunaire reconnaissable près des événements, un projet pédagogique peut illustrer la répétition du cycle et un outil de planification peut donner une première idée de la luminosité nocturne. Le champ de phase sert à une catégorisation lisible. L’âge et la fraction du cycle conviennent mieux au tri, aux indicateurs visuels et à la comparaison de dates proches, tandis que illumination_percent donne une estimation intuitive de la clarté. Puisque l’algorithme reçoit uniquement une date, il ne calcule ni lever, ni coucher, ni hauteur, ni azimut, ni éclipse, ni visibilité locale, ni météo, ni orientation apparente du croissant. Ces questions exigent des coordonnées, une heure exacte et des données orbitales détaillées. N’employez pas cette approximation pour la navigation, la sécurité, une publication scientifique, une décision religieuse exigeant une observation autorisée ou un événement dépendant de l’instant précis d’une phase. Pour une consultation ordinaire ou l’interface d’une application, elle reste transparente, économique et identique à chaque exécution. Le navigateur fonctionne sans serveur ; chaque requête automatisée à l’API coûte $0.002.
Cas d’usage
Ajouter une phase à un calendrier
Affichez une phase approximative près des événements sans interroger un service astronomique externe.
Préparer une séance photo nocturne
Comparez l’éclairage estimé de plusieurs dates avant de vérifier les horaires locaux et la météo.
Expliquer le cycle lunaire
Produisez des exemples reproductibles de phases croissantes, pleines et décroissantes pour un cours.
Questions fréquentes
Quelle est la précision de l’estimation ?
Elle convient à un calendrier général. Comme elle utilise un mois lunaire moyen et non des éphémérides complètes, l’instant exact peut différer de plusieurs heures.
Quelle heure de la journée est retenue ?
Le calcul évalue la date fournie à 12:00 UTC afin de ne jamais dépendre du fuseau horaire local.
Le lever ou le coucher de la Lune est-il calculé ?
Non. Ces horaires demandent une position géographique et un modèle astronomique plus détaillé.
Quel format de date faut-il employer ?
Utilisez exactement AAAA-MM-JJ avec un mois et un jour grégoriens valides, par exemple 2024-04-08.
Quel est le prix d’une requête API ?
Chaque requête API coûte $0.002. La version pour navigateur peut s’exécuter localement sans appeler l’API.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"date": "2024-04-08"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "misc2.moon_phase_estimate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |