Aller au contenu

Méthode

Sources et méthode de calcul

Calendrier Clair sert à consulter des dates et à préparer son calendrier. Les calculs locaux et les faits issus de sources externes sont distingués ; une donnée manquante n’est jamais remplacée par une supposition.

Comment

Comment les réponses sont produites

  • Dates et semaines. Le calendrier grégorien et la norme ISO 8601 déterminent les jours, les semaines et les écarts entre dates. Ces réponses sont calculées localement, sans appel à une source de faits.
  • Jours fériés et vacances scolaires. Calendar Platform fournit les faits publiés pour l’année et le périmètre demandés. Les ponts sont ensuite déduits des seuls jours fériés servis, sous l’hypothèse explicite d’une semaine de travail du lundi au vendredi.
  • Couverture et provenance. Une réponse servie conserve son périmètre, son instantané et son empreinte. Une liste absente, non publiée ou refusée ne permet pas d’affirmer qu’il n’y a aucun événement : le site signale l’indisponibilité, ou masque le repère facultatif.

Chaîne de données

Une seule source de vérité

Les jours fériés, les vacances scolaires et la résolution des communes sont lus via les API publiques de Calendar Platform. Pour ces faits, le site ne substitue ni une autre source ni un calcul à une publication manquante. Les sources complémentaires sont détaillées plus bas ; les ponts et les calculs de dates sont produits localement.

Contrat consommateur
calendar-consumer-contract.v2
État de connexion
connecté
Service interrogé
Calendar Platform — service de données calendaires (API publiques)
Provenance affichée
instantané + empreinte, par réponse

Périmètres

Pourquoi nous demandons un périmètre

  • Jours fériés. Il n’existe pas de vérité nationale unique : l’Alsace-Moselle, les départements et collectivités d’outre-mer ont leurs propres régimes. Chaque fait est affiché avec son périmètre.
  • Vacances scolaires. Les zones A, B et C ne concernent que les académies de métropole. La Corse et les territoires ultramarins ont des calendriers distincts, jamais ramenés à A, B ou C. Là où notre source ne dessert aucune zone (Wallis-et-Futuna, Nouvelle-Calédonie), l’information reste explicitement inconnue.
  • Deux dimensions indépendantes. Le périmètre des jours fériés et la zone scolaire sont conservés séparément : l’un ne déduit jamais l’autre.
  • Ambiguïté assumée. Si un code postal correspond à plusieurs communes, nous affichons les candidates et vous laissons choisir.

Limites

Ce que nous ne publions pas

  • Vendredi saint. Notre source ne le dessert pas sans applicabilité communale faisant autorité. Nous ne le reconstituons pas et ne l’empruntons pas à une autre source.
  • Ponts. Suggestions dérivées sous hypothèse lundi–vendredi, présentées séparément des jours fériés et des congés à poser. Elles sont calculées localement à partir des jours fériés publiés pour le périmètre choisi et ne constituent pas un droit au congé.
  • Données non publiées. Quand notre source n’a pas d’instantané actif, nous affichons un état « données pas encore publiées » plutôt qu’un exemple crédible.

Sources complémentaires

Saint du jour, élections, soleil

  • Saint du jour. Fourni par l’API d’intégration officielle Nominis (Église catholique en France), conformément à sa condition d’intégration : un lien visible vers Nominis accompagne la donnée. Nous n’affichons que le nom, éventuellement une courte précision, et la source ; les notices biographiques de Nominis ne sont jamais republiées. En cas d’indisponibilité, la rubrique disparaît simplement. Les réponses sont mises en cache côté serveur, par date : aucun instantané annuel n’est constitué, chaque journée est demandée à Nominis puis conservée temporairement.
  • Élections. Uniquement les scrutins dont la date exacte est publiée par le ministère de l’Intérieur : municipales et communautaires et élection présidentielle. Pour l’élection présidentielle de 2027, sept territoires votent la veille de la date métropolitaine pour raisons de décalage horaire ; cette exception est documentée par Service-Public.fr. Aucune date n’est anticipée avant publication officielle, et aucun détail local (bureau de vote, candidats, inscription) n’est déduit.
  • Phases de la Lune. Calculées localement (algorithmes astronomiques classiques de Jean Meeus, chapitre 49), sans API externe. Nous publions la date des quatre phases principales, rapportée à l’heure de Paris, ainsi qu’une fraction éclairée indicative. Nous ne prétendons pas à une précision locale à la minute et n’affichons ni heure de lever ni heure de coucher de la Lune.
  • Lever et coucher du soleil. Rattachés à la même localisation que le module météo (données WeatherAPI.com, y compris son volet astronomie). Les heures sont exprimées dans le fuseau de la localisation affichée ; aucune heure n’est affichée si la localisation n’est pas connue.

Calculs locaux

Ce que nous calculons nous-mêmes

Le jour de la semaine, le numéro de semaine ISO 8601, le jour de l’année, les années bissextiles, les écarts entre dates et les jours ouvrés sont de l’arithmétique civile. Ils sont calculés localement et ne dépendent d’aucune publication externe.