calendar |
Calendrier |
|---|---|
Python |
|
Description
Ce module contient les fonctions permettant de travailler avec des calendriers, y compris une certaine émulation du programme Unix.
Liste des classes
| Nom | Description |
|---|---|
| Calendar | Cette classe permet de créer un objet Calendar. |
| HTMLCalendar | Cette classe permet de générer des calendriers HTML. |
| LocaleHTMLCalendar | Cette classe permet de recevoir un nom de locale dans le constructeur et renvoie les noms de mois et de jour de semaine dans la locale spécifiée dans un format HTML. |
| LocaleTextCalendar | Cette classe permet de recevoir un nom de locale dans le constructeur et renvoie les noms de mois et de jour de semaine dans la locale spécifiée dans un format de texte brut. |
| TextCalendar | Cette classe permet de générer des calendriers en texte brut. |
Liste des procédures et fonctions
| Nom | Description |
|---|---|
| calendar | Cette fonction permet de demander un calendrier à 3 colonnes pour une année entière sous la forme d'une chaîne de caractères de plusieurs lignes à l'aide du formatyear() de la classe TextCalendar. |
| firstweekday | Cette fonction permet de demander la valeur actuel du jour de la semaine pour commencer chaque semaine. |
| isleap | Cette fonction permet de vérifier si l'année est une année bissextile. |
| leapdays | Cette fonction permet de demander le nombre d'années bissextiles dans l'intervalle exclusivement. Cette fonction fonctionne pour l'intervalle couvrant un changement de siècle. |
| month | Cette fonction permet de demander le calendrier d'un mois dans une chaîne de caractères de plusieurs lignes à l'aide du formatmonth() de la classe TextCalendar. |
| monthcalendar | Cette fonction permet de demander une matrice représentant le calendrier d'un mois. Chaque ligne représente une semaine; jours en dehors du mois a représentés par des zéros. Chaque semaine commence le Lundi, sauf si défini par setfirstweekday(). |
| monthrange | Cette fonction permet de demander le jour de la semaine du premier jour du mois et le nombre de jours du mois, pour l'année et le mois spécifiés. |
| prcal | Cette fonction permet d'afficher le calendrier pour une année entière tel que renvoyé par calendar(). |
| prmonth | Cette fonction permet d'afficher le calendrier d'un mois renvoyé par month(). |
| setfirstweekday | Cette fonction permet de fixer le jour de la semaine (0=Lundi, 6=Dimanche) pour commencer chaque semaine. |
| timegm | Cette fonction permet de prendre un tuple temporel tel que renvoyé par la fonction gmtime() dans le module time, et renvoie la valeur d'horodatage Unix correspondante, en supposant une époque de 1970, et l'encodage POSIX. |
| weekday | Cette fonction permet de demander le jour de la semaine (0 correspond à Lundi) pour l'année (1970 au supérieur), le mois (1 à 12), le jour du mois (1 à 31). |
| weekheader | Cette fonction permet de demander un entête contenant des noms de semaine abrégés. |
Liste des attributs
| Nom | Description |
|---|---|
| day_abbr | Cette attribut contient un tableau représentant les jours abrégés de la semaine dans les paramètres régionaux actuels. |
| day_name | Cette attribut contient un tableau représentant les jours de la semaine dans les paramètres régionaux actuels. |
| month_abbr | Cette attribut contient un tableau représentant les mois abrégés de l'année dans l'environnement local actuel. |
| month_name | Cette attribut contient un tableau représentant les mois de l'année dans l'environnement local actuel. |
Remarques
- Ce module vous permet de produire des calendriers comme la commande cal du système d'exploitation Unix et fournit des fonctions utiles supplémentaires liées au calendrier. Par défaut, ces calendriers ont le Lundi comme premier jour de la semaine et le Dimanche comme dernier (la convention européenne). Utilisez setfirstweekday() pour définir le premier jour de la semaine sur Dimanche (6) ou sur tout autre jour de la semaine. Les paramètres spécifiant des dates sont donnés sous forme d'entiers. Pour les fonctionnalités associées, voir également les modules datetime et time.
- Les fonctions et classes définies dans ce module utilisent un calendrier idéalisé, le calendrier grégorien actuel s'étendant indéfiniment dans les deux sens. Cette situation correspond à la définition du calendrier grégorien proleptique dans le livre «Calendrical Calculations» de Dershowitz et Reingold, où il s'agit du calendrier de base pour tous les calculs. Les années zéro et négative sont interprétées conformément à la norme ISO 8601. L'année 0 est 1 BC, l'année -1 est 2 BC, et ainsi de suite.
Dernière mise à jour : Vendredi, le 3 janvier 2020