CAL_TO_JD |
Calendrier à jour julien |
|---|---|
| PHP 4.0.7+ | Extension CALENDAR |
Syntaxe
| function cal_to_jd($calendar,$month,$day,$year); |
Paramètres
| Nom | Description | |
|---|---|---|
| $calendar | Ce paramètre permet d'indiquer le format de calendrier utilisé : | |
| Constante | Description | |
| CAL_GREGORIAN | Cette constante permet d'indiquer un calendrier grégorien. | |
| CAL_JULIAN | Cette constante permet d'indiquer un calendrier Julien. | |
| CAL_JEWISH | Cette constante permet d'indiquer un calendrier Juif. | |
| CAL_FRENCH | Cette constante permet d'indiquer un calendrier français. | |
| $month | Ce paramètre permet d'indiquer le mois : | |
| Valeur | Description | |
| 1 | Cette valeur permet d'indiquer le mois de Janvier | |
| 2 | Cette valeur permet d'indiquer le mois de Février | |
| 3 | Cette valeur permet d'indiquer le mois de Mars | |
| 4 | Cette valeur permet d'indiquer le mois d'Avril | |
| 5 | Cette valeur permet d'indiquer le mois de Mai | |
| 6 | Cette valeur permet d'indiquer le mois de Juin | |
| 7 | Cette valeur permet d'indiquer le mois de Juillet | |
| 8 | Cette valeur permet d'indiquer le mois d'Août | |
| 9 | Cette valeur permet d'indiquer le mois de Septembre | |
| 10 | Cette valeur permet d'indiquer le mois d'Octobre | |
| 11 | Cette valeur permet d'indiquer le mois de Novembre | |
| 12 | Cette valeur permet d'indiquer le mois de Décembre | |
| $day | Ce paramètre permet d'indiquer le jour du mois (1 à 31) | |
| $year | Ce paramètre permet d'indiquer l'année (-4713 à -1 et 1 à la limite de la version) | |
Retour
| Valeur | Description |
|---|---|
| nombre | Ces valeurs indique le nombre de jour en Julien. |
Description
Cette fonction permet d'effectuer la conversion d'un format de calendrier en nombre de jour Julien.
Remarques
- Utilité principale : La fonction cal_to_jd permet de convertir une date dans un calendrier donné (par exemple, le calendrier grégorien, julien, hébraïque,...) en un Julian Date (JD). Le Julian Date est un nombre décimal représentant le nombre de jours depuis le début de l'ère julienne (1er janvier 4713 av. J.-C.).
- Calendriers supportés : Elle prend en charge plusieurs systèmes de calendrier, comme CAL_GREGORIAN, CAL_JULIAN, CAL_HEBREW, CAL_ISLAMIC, et autres. Cela en fait une fonction polyvalente pour gérer différentes cultures et systèmes de datation.
- Paramètres : La fonction nécessite trois paramètres : l'année, le mois et le jour de la date à convertir. Ces paramètres doivent être des entiers, et la fonction retourne un nombre décimal qui représente la date julienne correspondante.
- Précision des calculs : Le résultat retourné par cal_to_jd est un nombre décimal, où la partie entière représente le jour et la partie décimale représente l'heure (dans une échelle de 0 à 1 pour une journée complète). Cela permet de représenter la date et l'heure avec une précision élevée.
- Conversion inverse : La fonction inverse de cal_to_jd est jd_to_cal(), permettant de convertir une Julian Date en une date dans le calendrier spécifié. Cela facilite les conversions dans les deux sens entre les dates calendaires et juliennes.
- Utilisation en astrologie et astronomie : Le Julian Date est largement utilisé en astronomie et en astrologie pour exprimer des dates de manière uniforme et indépendante de tout calendrier spécifique. Cela permet de comparer facilement des événements dans le temps sur de longues périodes.
- Limitations liées aux calendriers : Bien que la fonction soit pratique, elle dépend des conventions historiques des calendriers. Par exemple, le calendrier julien et le calendrier grégorien ont des différences historiques notables dans la gestion des années bissextiles, ce qui peut entraîner des variations lors des conversions de dates autour de certaines périodes.
- Compatibilité PHP : La fonction cal_to_jd fait partie de l'extension Calendar de PHP. Cela signifie qu'elle nécessite que cette extension soit activée dans votre environnement PHP. De plus, l'extension Calendar n'est pas incluse par défaut dans toutes les installations PHP, ce qui peut nécessiter une configuration supplémentaire pour l'utiliser.
Dernière mise à jour : Mercredi, le 25 mars 2015