5.9 calendar ---
Fonctions générales relatives au calendrier
Ce module vous permet de produire des calendriers comme avec le programme
cal d'Unix, et fournit d'utiles fonctions additionnelles
relatives au calendrier. Par défaut, ces calendriers ont le lundi comme
premier jour de la semaine, et dimanche comme le dernier (c'est la
convention européenne). Utilisez setfirstweekday() pour définir
le premier jour de la semaine au dimanche (6) ou à tout autre jour.
setfirstweekday(jour)
- Définit le jour (
0 pour lundi, 6 pour dimanche) qui commence
chaque semaine. Les valeurs MONDAY, TUESDAY,
WEDNESDAY, THURSDAY, FRIDAY,
SATURDAY, et SUNDAY sont fournies par commodité.
Par exemple, pour faire commencer la semaine le dimanche:
import calendar
calendar.setfirstweekday(calendar.SUNDAY)
firstweekday()
- Retourne la définition courante du jour de début de semaine.
isleap(annee)
- Retourne vrai si annee est une année bissextile.
leapdays(y1, y2)
- Retourne le nombre d'années bissextiles dans la plage
[y1...y2].
weekday(annee, mois, jour)
- Retourne le jour de la semaine (
0 pour lundi) pour annee(1970--...), mois (1--12), jour(1--31).
monthrange(annee, mois)
- Retourne le jour de la semaine du premier jour du mois et le nombre de jours
dans le mois, pour les annee et mois spécifiés.
monthcalendar(annee, mois)
- Retourne une matrice représentant le calendrier d'un mois. Chaque ligne
représente une semaine; les jours en-dehors du mois sont représentés par
des zéros. Chaque semaine commence le lundi, sauf si un autre jour a été défini
par setfirstweekday().
prmonth(annee, mois[, w[, l]])
- Imprime le calendrier d'un mois, tel que retourné par month().
month(annee, mois[, w[, l]])
- Retourne le calendrier d'un mois sous forme d'une chaîne de caractères
multilignes. Si w est fourni, il s'agit de la largeur de la colonne
des dates, qui sont centrées. Si l est donné, il s'agit du nombre de
lignes que chaque semaine utilise. L'ensemble dépend du premier jour
de la semaine, tel que défini par setfirstweekday().
prcal(annee[, w[, l[c]]])
- Imprime le calendrier d'une année entière, tel que retourné par
calendar().
calendar(annee[, w[, l[c]]])
- Retourne un calendrier de 3 colonnes pour une année entière sous forme
d'une chaîne de caractères multilignes. Les paramètres optionnels
w, l et c indiquent respectivement la largeur des
colonnes de dates, le nombre de lignes par semaine, et le nombre d'espaces
entre les colonnes de mois. Dépendant du premier jour de la semaine, tel
que défini par setfirstweekday().
timegm(tuple)
- Une fonction sans rapport mais pratique, qui prend un tuple temporel
tel que retourné par la fonction gmtime() dans le module
time, et retourne l'empreinte temporelle Unix correspondante,
en prenant comme origine des temps 1970, et l'encodage POSIX. En fait,
time.gmtime() et timegm() sont les inverses l'un
de l'autre.
Voir aussi:
- Module time:
- Fontions temporelles de bas niveau apparentées.
