Convertisseur grégorien → hégire

Convertir une date civile grégorienne en date islamique de l’hégire est un besoin quotidien pour la planification, la documentation, l’enseignement et les fonctions produit qui doivent afficher les deux calendriers côte à côte. Fêtes religieuses, libellés fiscaux, certificats et chaînes de localisation stockent souvent un système et doivent afficher l’autre sans dépendre de l’horloge du navigateur ni d’un service astronomique distant. Ce convertisseur grégorien vers hégire accepte une date de calendrier ISO explicite au format YYYY-MM-DD, la traite comme un jour civil UTC (sans heure de la journée et sans décalage de fuseau local) et renvoie l’année, le mois et le jour de l’hégire civile tabulaire correspondants via l’algorithme arithmétique koweïtien bien connu. L’algorithme est un calcul entier entièrement déterministe : jour grégorien vers numéro de jour julien, puis JDN vers hégire sur le cycle bissextile fixe de 30 ans. Ce n’est pas une observation lunaire ; les calendriers administratifs et de nombreux logiciels utilisent cette convention civile, qui peut différer d’un jour de l’observation religieuse locale.

Ce que signifie l’hégire civile tabulaire et en quoi elle diffère de l’observation lunaire

Le calendrier islamique est un calendrier lunaire pur de douze mois qui, dans le schéma civil, alternent entre vingt-neuf et trente jours, avec un jour intercalaire ajouté au douzième mois lors des années bissextiles d’un cycle de trente ans. Onze années sur trente sont bissextiles selon la convention arithmétique (tabulaire) courante, ce qui donne une durée moyenne d’année de trois cent cinquante-quatre et onze trentièmes de jour.

Ce calendrier arithmétique est parfois appelé hégire civile ou tabulaire parce que les administrations, bases de données et nombreuses bibliothèques utilisent des règles fixes plutôt que d’attendre une observation locale du croissant. Les calendriers d’observation lunaire utilisés pour le culte dans une ville donnée peuvent démarrer le mois un jour plus tôt ou plus tard que la table civile ; cette capacité documente volontairement la voie civile afin que les résultats restent reproductibles d’une machine et d’une année à l’autre.

La conversion ne consulte ni almanachs, ni satellites, ni APIs : pour la même entrée ISO grégorienne, chaque client reçoit la même année, le même numéro de mois, le même nom de mois et le même jour de l’hégire. L’époque civile de l’algorithme place le 1er muharram de l’an 1 AH sur le jour grégorien proleptique que codent les entiers koweïtiens (classiquement lié à la mi-juillet 622 de l’ère commune dans le comput julien).

Lorsque vous publiez des documents à double datation, associez ce convertisseur à un libellé clair tel que AH civil tabulaire afin que les lecteurs sachent que vous ne revendiquez pas une date d’observation de type fatwa. Si votre produit doit correspondre à une autorité religieuse nationale précise, utilisez le mappage publié par cette autorité plutôt que de traiter une table arithmétique unique comme vérité sacrée universelle.

Contrat d’entrée, sémantique du jour UTC et champs de réponse

La valeur doit être exactement quatre chiffres, un tiret, deux chiffres, un tiret et deux chiffres : YYYY-MM-DD. Le jour doit exister sur le calendrier grégorien proleptique : mois entre 01 et 12, jour dans la longueur de ce mois, et 29 février uniquement les années bissextiles. Les années hors de 0001–9999 sont rejetées.

Il n’y a ni composante horaire ni décalage de fuseau dans la requête : la chaîne est interprétée comme un jour civil UTC entier, de sorte que deux appelants dans des zones différentes ne scindent jamais la même chaîne de date à minuit. Exemple : 2000-01-01 se convertit en 24 Ramadan 1420 AH selon cette table civile. N’envoyez pas Date.now() sans d’abord formater un jour de calendrier fixe ; la capacité ne lit jamais l’horloge du serveur.

Où cette conversion vers l'hégire rend service

Les équipes produit qui livrent des lignes de date bilingues sur billets, diplômes et formulaires officiels ont besoin d’une seule fonction qui transforme une date ISO stockée en chaîne AH stable sans embarquer de grandes bibliothèques de calendrier dans chaque client. Les plateformes éducatives qui enseignent les systèmes de calendrier peuvent montrer le cycle civil des années bissextiles à côté des règles bissextiles grégoriennes et laisser les étudiants vérifier leurs devoirs sans scraper des sites tiers qui changent d’algorithme en silence.

Les pipelines de localisation qui génèrent des e-mails ou des PDF en plusieurs locales peuvent appeler ce point de terminaison une fois par date de document et mettre en cache les champs structurés.