CAL_INFO |
Information de calendrier |
|---|---|
| PHP 4.1.0+ | |
Syntaxe
| function cal_info([ $calendar = -1 ]); |
Paramètres
| Nom | Description | |
|---|---|---|
| $calendar | Ce paramètre permet de représenter le type de calendrier pour lequel vous souhaitez obtenir des informations. Il doit être un code entier correspondant à l'un des calendriers pris en charge par PHP. Ces codes sont définis dans l'extension calendar de PHP. Voici les calendriers supportés et leurs codes : | |
| Valeur | Description | |
| CAL_GREGORIAN (0) | Le calendrier Grégorien, utilisé dans la majeure partie du monde. | |
| CAL_JULIAN (1) | Le calendrier Julien, utilisé avant l'introduction du calendrier Grégorien. | |
| CAL_JEWISH (2) | Le calendrier Juif, utilisé par la communauté juive. | |
| CAL_FRENCH (3) | Le calendrier républicain français, utilisé brièvement après la Révolution française. | |
| CAL_HEBREW (4) | Le calendrier Hébraïque, utilisé pour déterminer les fêtes juives et les événements religieux. | |
Description
Cette fonction permet de demander les informations à propos d'un calendrier spécifié.
Remarques
- Utilité principale : La fonction cal_info permet de récupérer des informations sur un calendrier spécifique en PHP. Elle est principalement utilisée pour obtenir des détails sur les propriétés d'un calendrier donné, telles que son nom, les jours de la semaine, les mois et d'autres paramètres associés au calendrier.
- Paramètres de la fonction : La fonction prend un paramètre obligatoire, le code du calendrier, correspondant à un des types de calendriers pris en charge par PHP, comme le calendrier Grégorien, Julien, ou d'autres systèmes utilisés à travers le monde. Le calendrier Grégorien est utilisé par défaut si aucun paramètre n'est spécifié.
- Valeurs retournées : cal_info retourne un tableau associatif contenant diverses informations liées au calendrier spécifié. Ces informations peuvent inclure des mois, des jours de la semaine, la longueur du mois et la première année du calendrier.
- Prise en charge de différents calendriers : PHP prend en charge plusieurs systèmes de calendrier via cette fonction, y compris le calendrier Grégorien, Julien, Hébraïque, et d'autres. Cela permet aux développeurs de travailler avec des calendriers non européens, ce qui est particulièrement utile pour les applications multilingues ou multiculturelles.
- Exemple de retour : Le tableau retourné par cal_info contient des clefs telles que months, weekdays, et year_length, étant des informations utiles pour afficher un calendrier ou pour effectuer des calculs basés sur des dates dans différents formats.
- Limitations : La fonction cal_info ne permet pas de manipuler ou de convertir des dates entre calendriers différents, elle se limite à fournir des informations descriptives sur un calendrier. Pour des conversions de dates, il est nécessaire d'utiliser d'autres fonctions telles que cal_to_jd ou jd_to_cal.
- Dépendance de l'extension Calendar : Cette fonction nécessite que l'extension calendar soit activée dans la configuration PHP pour être utilisée. Par défaut, cette extension n'est pas activée sur toutes les installations PHP, ce qui peut poser problème si l'extension n'est pas présente.
- Précision sur les années bissextiles : Lors de l'utilisation de la fonction cal_info avec des calendriers comme le Grégorien, PHP prend en compte les années bissextiles pour déterminer la longueur d'un mois de février. Cette fonctionnalité est cruciale pour effectuer des calculs précis de dates tout au long de l'année.
Dernière mise à jour : Jeudi, le 28 Mai 2020