datetime |
Date et heure |
---|---|
Python |
Description
Ce module contient les types de base de date et d'heure.
Liste des classes
Nom | Description |
---|---|
date | Cette classe contient une date naïve idéalisée, en supposant que le calendrier grégorien actuel a toujours été et sera toujours en vigueur. Elle utilise les attributs year (année), month (mois) et day (jour). |
datetime | Cette classe contient une combinaison d'une date et d'une heure. Les attributs sont year (année), month (mois), day (jour), hour (heure), minute (minute), second (seconde), microsecond (microseconde) et tzinfo. |
time | Cette classe contient un heure idéalisé, indépendant d'un jour particulier, en supposant que chaque jour a exactement 24 x 60 x 60 secondes. Il n'y a aucune notion de «secondes intercalaires» ici. Les attributs sont hour (heure), minute (minute), second (seconde), microsecond (microseconde) et tzinfo. |
timedelta | Cette classe permet d'indiquer la durée exprimant la différence entre deux instances de date, time ou de datetime à une résolution en microsecondes. |
timezone | Cette classe contient une mise ne oeuvre de classe de base abstraite tzinfo en tant que décalage fixe par rapport à l'UTC. |
tzinfo | Cette classe contient la base abstraite pour les objets d'information de fuseau horaire. Ceux-ci sont utilisés par les classes datetime et time pour fournir une notion personnalisable de réglage de l'heure (par exemple, pour tenir compte du fuseau horaire et/ou de l'heure d'été). |
Liste des constantes
Nom | Description |
---|---|
MINYEAR | Cette constante permet d'indiquer le plus petit numéro d'année autorisé dans un objet date ou datetime. La valeur de MINYEAR est 1. |
MAXYEAR | Cette constante permet d'indiquer le plus grand numéro d'année autorisé dans un objet date ou datetime. La valeur de MAXYEAR est 9999. |
Remarques
- Bien que l'arithmétique de la date et de l'heure soit prise en charge, la mise en oeuvre se concentre sur l'extraction efficace des attributs pour le formatage et la manipulation des sorties.
- Les objets de date et d'heure peuvent être classés selon les catégories conscientes ou naïves.
- Avec une connaissance suffisante des ajustements algorithmiques et politiques de l'heure applicables, tels que les informations de fuseau horaire et d'heure d'été, un objet conscientes peut se localiser par rapport à d'autres objets conscientes. Un objet conscient représente un moment précis dans le temps n'étant pas ouvert à l'interprétation.
- Un objet naïf ne contient pas suffisamment d'informations pour se localiser sans ambiguïté par rapport à d'autres objets de date et d'heure. Qu'un objet naïf représente le temps universel coordonné (UTC), l'heure locale ou l'heure dans un autre fuseau horaire dépend uniquement du programme, tout comme il appartient au programme de savoir si un nombre particulier représente des mètres, des miles ou une masse. Les objets naïfs sont faciles à comprendre et à utiliser, au prix d'ignorer certains aspects de la réalité.
- Pour les applications nécessitant des objets conscients, les objets datetime et time ont un attribut facultatif d'informations de fuseau horaire, tzinfo, pouvant être défini sur une instance d'une sous-classe de la classe tzinfo abstraite. Ces objets tzinfo capturent des informations sur le décalage par rapport à l'heure UTC, le nom du fuseau horaire et si l'heure d'été est en vigueur.
- Une seule classe tzinfo concrète, la classe timezone, est fournie par le module datetime. La classe de fuseau horaire peut représenter des fuseaux horaires simples avec des décalages fixes par rapport à l'UTC, tels que l'UTC lui-même ou les fuseaux horaires nord-américains EST et EDT. La prise en charge des fuseaux horaires à des niveaux de détails plus approfondis dépend de l'application. Les règles d'ajustement de l'heure à travers le monde sont plus politiques que rationnelles, changent fréquemment et il n'y a pas de norme adaptée à chaque application en dehors de l'UTC.
Dernière mise à jour : Vendredi, le 3 janvier 2020