Pour les développeurs

Les données du site, en accès libre

Tout ce que ce site affiche sort de fichiers JSON publics, calculés selon la méthode décrite ici. Ils sont réutilisables librement, avec une mention de la source. Pas de clé, pas de quota : de simples fichiers statiques, mis en cache, servis avec les en-têtes CORS.

Les fichiers

Fichiers de données disponibles
FichierContenuTaille
/assets/data/moon-2026.jsonUne année : chaque jour (days) et chaque phase majeure (events). Années 2026 à 2035.~65 Ko
/assets/data/riseset-2026.jsonLever et coucher de la Lune, jour par jour, pour Paris, Lille, Strasbourg, Nantes, Bordeaux, Toulouse, Lyon, Marseille, Ajaccio.~60 Ko

Champs de days[]

  • d date (YYYY-MM-DD, jour civil de Paris) · p phase (new_moon, waxing_crescent, first_quarter, waxing_gibbous, full_moon, waning_gibbous, last_quarter, waning_crescent)
  • i illumination (0-1) · a âge de la Lune en jours · k distance Terre-Lune en km, à midi heure de Paris
  • t lune montante ou descendante (déclinaison) · g jour racine, fleur, feuille ou fruit (zodiaque sidéral)
  • zt signe tropical · zs signe sidéral · c constellation (nom latin)
  • r, s lever et coucher à Paris (HH:MM, heure locale) ou null

Champs de events[]

  • d date (Paris) · t type (new_moon, first_quarter, full_moon, last_quarter) · h heure de Paris · u instant UTC ISO 8601 · k distance en km · sm true pour une superlune

Exemple

fetch("https://www.calendrierlunaire.com/assets/data/moon-2026.json")
  .then(r => r.json())
  .then(data => {
    const today = new Intl.DateTimeFormat("sv-SE", { timeZone: "Europe/Paris" }).format(new Date());
    const day = data.days.find(d => d.d === today);
    console.log(day.p, Math.round(day.i * 100) + " %", "lever " + day.r);
  });

Pour un affichage clé en main, le widget fait tout cela en deux lignes.

Conditions de réutilisation

Les données sont mises à disposition sous licence Creative Commons Attribution 4.0 (CC BY 4.0) : réutilisation, modification et redistribution libres, y compris commerciales, à condition d'indiquer la source « calendrierlunaire.com » avec un lien. Les calculs proviennent d'astronomy-engine (licence MIT) ; les heures sont en heure légale française.

Les fichiers sont régénérés à chaque publication du site. Ne les copiez pas sur vos serveurs si vous pouvez les appeler directement : vous bénéficierez des corrections.

Questions fréquentes

Puis-je utiliser ces données dans une application ?

Oui, y compris commerciale, sous licence CC BY 4.0 : il suffit de mentionner calendrierlunaire.com comme source. Aucune clé ni inscription n'est nécessaire.

Les données sont-elles précises ?

Les instants des phases sont calculés à la minute et contrôlés contre timeanddate et la NASA ; les circonstances locales (lever, coucher) sont exactes à la minute pour un horizon dégagé. Le détail est sur la page méthode.

Y a-t-il une API ?

Pas au sens dynamique : ce sont des fichiers statiques par année, ce qui les rend rapides, cachables et sans quota. Un appel par an suffit pour tout un calendrier.

Puis-je demander d'autres villes ou d'autres champs ?

Oui, via la page contact. Les demandes raisonnables (villes françaises, champs calculables) sont ajoutées à la génération suivante.