ForHosting KIT · Outils pour développeurs

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.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/misc2/moon-phase-estimate

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é.

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"}'
{
  "date": "2024-04-08"
}
{
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →