CAL_FROM_JD |
Calendrier de jour |
|---|---|
| PHP 4.1.0+ | |
Syntaxe
| function cal_from_jd($jd, $calendar); |
Paramètres
| Nom | Description | |
|---|---|---|
| $jd | Ce paramètre permet de représenter le jour julien (Julian Day Number, JDN) que vous souhaitez convertir. Le JDN est un nombre entier représentant un jour spécifique dans le calendrier julien, comptant depuis le 1er janvier 4713 avant Jésus-Christ (date de départ du calendrier julien). Ce nombre est utilisé dans l'astronomie et d'autres domaines pour faciliter les calculs de dates à long terme. | |
| $calendar | Ce paramètre permet d'indiquer le type de calendrier utilisé pour la conversion. Il permet à la fonction de savoir quel système de calendrier utiliser pour retourner la date. Les valeurs possibles pour ce paramètre incluent : | |
| Valeur | Description | |
| "gregorian" | Cette valeur permet d'indiquer le calendrier grégorien, utilisé par la plupart des pays aujourd'hui. | |
| "julian" | Cette valeur permet d'indiquer le calendrier julien, un système de calendrier antérieur au calendrier grégorien. | |
| "french" | Cette valeur permet d'indiquer le calendrier républicain français, utilisé entre 1792 et 1806. | |
Description
Cette fonction permet de convertir un nombre de jours en format Julien en un calendrier spécifié.
Remarques
- Conversion de jour julien à calendrier : La fonction cal_from_jd est utilisée pour convertir une date au format julien (Julian Day Number, JDN) en une date du calendrier spécifique. Le JDN est un nombre représentant le nombre de jours écoulés depuis le 1er janvier 4713 avant J.-C., et cette fonction permet de récupérer la date sous une forme lisible pour l'utilisateur.
- Paramètre d'entrée : Le paramètre principal de la fonction est un entier représentant le jour julien (JDN) à convertir. Ce nombre peut être obtenu par la fonction cal_to_jd. La fonction est ainsi idéale pour effectuer des conversions bidirectionnelles entre les formats.
- Types de calendriers supportés : La fonction permet de spécifier le type de calendrier à utiliser pour la conversion. En fonction du calendrier passé en paramètre (par exemple, "gregorian", "julian", "french"), la fonction renverra un tableau contenant la date correspondante.
- Tableau de sortie : Le résultat de la conversion est retourné sous la forme d'un tableau associatif contenant les valeurs de jour, mois et année. Ce tableau peut être utilisé pour afficher la date dans un format lisible par l'utilisateur ou pour effectuer d'autres calculs.
- Attention aux dates extrêmes : Lors de l'utilisation de la fonction avec des dates très anciennes ou futures, il est essentiel de vérifier que le JDN passé en paramètre est valide, car des valeurs extrêmes peuvent entraîner des erreurs ou des résultats inattendus.
- Conversion de dates non grégoriennes : La fonction cal_from_jd est particulièrement utile pour les applications nécessitant la conversion de dates dans des calendriers non grégoriens. Par exemple, elle peut être utilisée pour afficher des dates dans le calendrier julien ou hébraïque, ce qui est utile dans certains domaines comme les études historiques ou religieuses.
- Précision des dates : La précision de la date retournée dépend du calendrier utilisé. Certains calendriers, comme le calendrier grégorien, peuvent avoir des ajustements complexes, par exemple les années bissextiles, affectant le calcul de la date.
- Cas d'utilisation : Cette fonction peut être utile dans des systèmes de gestion de dates complexes, comme les applications astronomiques, les logiciels de gestion de projets sur le long terme, ou pour afficher des dates historiques dans un format moderne. Elle permet de simplifier la conversion entre des systèmes de date n'étant pas directement compatibles avec le calendrier grégorien.
Dernière mise à jour : Jeudi, le 28 Mai 2020