fonctions¶

time.asctime()¶

convertir un tuple ou struct_time représentant unegmtime() ou localtime() à une chaîne de la forme suivante: 'Sun Jun 20 23:21:05 1993'. Le champ jour est long de deux caractères et est rempli d’espace si le jour est un seul chiffre, par exemple: 'Wed Jun 9 04:26:40 1993'.,

Si t n’est pas fourni, l’heure actuelle renvoyée par localtime()est utilisée. Les informations locales ne sont pas utilisées par asctime().

Remarque

Contrairement à la fonction C du même nom, asctime() ne pas ajouter atrailing retour à la ligne.

time.pthread_getcpuclockid(thread_id)¶

renvoie le clk_id de l’horloge CPU spécifique au thread pour le thread_id spécifié.,

utilisezthreading.get_ident() ou l’attributidentdes objetsthreading.Thread pour obtenir une valeur appropriée pour thread_id.

avertissement

passer un thread_id non valide ou expiré peut entraîner un comportement inundefined, tel qu’un défaut de segmentation.

disponibilité: Unix (voir la page de manuel pour pthread_getcpuclockid(3) pour d’autres informations).

nouveau dans la version 3.7.

time.clock_getres(clk_id)¶

de Retour de la résolution (précision) de l’horloge clk_id., Reportez-vous aux constantes d’ID de verrouillage pour une liste de valeurs acceptées pour clk_id.

disponibilité: Unix.

nouveau dans la version 3.3.

time.clock_gettime(clk_id) → float¶

de Retour le temps de l’horloge clk_id. Reportez-vous aux constantes d’ID de verrouillage pour une liste de valeurs acceptées pour clk_id.

disponibilité: Unix.

nouveau dans la version 3.3.

time.clock_gettime_ns(clk_id) → int¶

type clock_gettime() mais l’heure de retour que nanosecondes.

disponibilité: Unix.

nouveau dans la version 3.7.,

time.clock_settime(clk_id, temps: float)¶

Régler l’heure de l’horloge clk_id. Actuellement,CLOCK_REALTIME est la seule valeur acceptée pour clk_id.

disponibilité: Unix.

nouveau dans la version 3.3.

time.clock_settime_ns(clk_id, temps: int)¶

type clock_settime() mais de temps ensemble avec nanosecondes.

disponibilité: Unix.

nouveau dans la version 3.7.,

time.ctime()¶

Convertir en un temps exprimé en secondes depuis l’époque d’une chaîne d’un formulaire:'Sun Jun 20 23:21:05 1993' représentant de l’heure locale. Le champ day est long de deux caractères et est rempli d’espace si le jour est un seul chiffre, par exemple: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(name)¶

obtenir des informations sur l’horloge spécifiée en tant qu’objet d’espace de noms.,Les noms d’horloge pris en charge et les fonctions correspondantes pour lire leur valeursont:

le résultat a les attributs suivants:

  • réglable: True si l’horloge peut être modifiée automatiquement (par exemple par un démon NTP) ou manuellement par l’administrateur système, False sinon

  • implémentation: nom de la fonction C sous-jacente utilisée pour obtenir la valeur d’horloge. Référez-vous aux constantes D’ID D’Horloge pour les valeurs possibles.,

  • monotone: True si l’horloge ne peut pas revenir en arrière,False sinon,

  • la résolution: La résolution de l’horloge en quelques secondes (float)

de Nouveau dans la version 3.3.

time.gmtime()¶

Convertir en un temps exprimé en secondes depuis l’epoch à un struct_time inUTC dans lequel le drapeau de l’heure d’été est toujours à zéro. Si sec n’est pas fourni ou si None, l’heure actuelle renvoyée par time() est utilisée., Les fractions d’une seconde sont ignorées. Voir ci-dessus pour une description de l’objetstruct_time. Voir calendar.timegm() pour l’inverse de cette fonction.

time.localtime()¶

Comme gmtime(), mais il se convertit à l’heure locale. Si sec n’est pas fourni ou si None, l’heure actuelle renvoyée par time() est utilisée. Le dstflag est défini sur 1 lorsque DST s’applique à l’heure donnée.,

time.mktime(t)¶

C’est la fonction inverse de localtime(). Son argument est lestruct_time ou le 9-tuple complet (puisque l’indicateur dst est nécessaire; utilisez-1comme indicateur dst s’il est inconnu) qui exprime l’heure en heure locale, notUTC. Il renvoie un nombre à virgule flottante, pour la compatibilité avec time().,Si la valeur d’entrée ne peut pas être représentée comme une heure valide,OverflowError ou ValueError seront déclenchés (ce qui dépend si la valeur invalide est capturée par Python ou les bibliothèques C sous-jacentes).La date la plus ancienne pour laquelle il peut générer une heure dépend de la plate-forme.

time.monotonic() → float¶

renvoie la valeur (en fractions de secondes) d’une horloge monotone, c’est-à-dire une horloge qui ne peut pas revenir en arrière. L’horloge n’est pas affectée par les mises à jour de l’horloge système.,Le point de référence de la valeur retournée n’est pas défini, de sorte que seule la différence entre les résultats des appels consécutifs est valide.

nouveau dans la version 3.3.

Modifié dans la version 3.5: La fonction est maintenant toujours disponible et toujours à l’échelle du système.

time.monotonic_ns() → int¶

type monotonic(), mais le temps de retour que nanosecondes.

nouveau dans la version 3.7.

time.perf_counter() → float¶

renvoie la valeur (en fractions de secondes) d’un compteur de performances, c’est-à-dire, aclock avec la plus haute résolution disponible pour mesurer une courte durée. Il comprend le temps écoulé pendant le sommeil et est à l’échelle du système. Le point de référence de la valeur retournée n’est pas défini, de sorte que seule la différence entre les résultats des appels consécutifs est valide.

nouveau dans la version 3.3.

time.perf_counter_ns() → int¶

type perf_counter(), mais le temps de retour que nanosecondes.

nouveau dans la version 3.7.,

time.process_time() → float¶

renvoie la valeur (en fractions de secondes) de la somme du temps système et userCPU du processus en cours. Il n’inclut pas le temps écoulé pendantle sommeil. C’est par définition à l’échelle du processus. Le point de référence de la valeur retournée est indéfini, de sorte que seule la différence entre les resultsof appels consécutifs est valide.

nouveau dans la version 3.3.

time.process_time_ns() → int¶

type process_time() mais l’heure de retour que nanosecondes.,

nouveau dans la version 3.7.

time.sleep(secs)¶

Suspendre l’exécution du thread appelant pour un nombre donné de secondes.L’argument peut être un nombre à virgule flottante pour indiquer une heure de sommeil plus précise. Le temps de suspension réel peut être inférieur à celui demandé car tout signal intercepté mettra fin à sleep() après l’exécution de la routine de capture de thatsignal. En outre, le temps de suspension peut être plus long que requis par une quantité arbitraire en raison de la planification d’autres activités dans le système.,

modifié dans la version 3.5: la fonction dort maintenant au moins secondes même si le sommeil est interrompu par un signal, sauf si le gestionnaire de signal déclenche une exception (voir 475 pour la justification).

time.strftime(format)¶

Convertir un tuple ou struct_time qui représente un temps tel que retourné par lagmtime() ou localtime() pour une chaîne comme spécifié par le formatargument. Si t n’est pas fourni, l’heure actuelle renvoyée parlocaltime() est utilisée. format doit être une chaîne., ValueError isised si un champ dans t est en dehors de la plage autorisée.

0 est un argument juridique pour n’importe quelle position dans le tuple temporel; s’il est normalementlegal, la valeur est forcée à une valeur correcte.

Les directives suivantes peuvent être intégrées dans la chaîne de format., Ils sont montrésans la spécification optionnelle de largeur de champ et de précision, et sont remplacés par les caractères indiqués dans la strftime() résultat:

Notes:

  1. lorsqu’ils sont utilisés avec la fonction strptime(), la directive %p affecte le champ Heure de sortie si la directive %I est utilisée pour analyser l’heure.,

  2. La gamme est vraiment 0 de 61 valeur 60 est valide intimestamps représentant les secondes intercalaires et de la valeur 61 est supportedfor des raisons historiques.

  3. Lorsqu’il est utilisé avec la balise strptime() fonction %U et %W ne sont utilisés que incalculations quand le jour de la semaine et de l’année sont spécifiés.

Voici un exemple, un format de dates compatible avec celui spécifié dans la norme de messagerie Internet cfc2822., 1

>>> from time import gmtime, strftime>>> strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())'Thu, 28 Jun 2001 14:17:15 +0000'

des directives supplémentaires peuvent être prises en charge sur certaines plates-formes, mais seules les zones listées ici ont une signification normalisée par ANSI C. pour voir l’ensemble des codes de format pris en charge sur votre plate-forme, consultez la documentation strftime(3).

sur certaines plates-formes, une Spécification facultative de largeur de champ et de précision peut suivre immédiatement l’initiale '%' d’une directive dans l’ordre suivant;ce n’est pas non plus portable. La largeur du champ est normalement 2 sauf pour %j où il vaut 3.,

time.strptime(string)¶

Analyser une chaîne de caractères représentant une fois et selon un format. Le retour valueis un struct_time retourné par gmtime() oulocaltime().

le paramètre format utilise les mêmes directives que celles utilisées parstrftime(); il est par défaut"%a %b %d %H:%M:%S %Y"qui correspond au formatage renvoyé parctime(). Si la chaîne ne peut pas être analysée selon le format, ou si elle a des données excédentaires après l’analyse, ValueError isrised., Les valeurs par défaut utilisées pour remplir les données manquantes lorsque les valeurs moreaccurate ne peuvent pas être déduites sont (1900, 1, 1, 0, 0, 0, 0, 1, -1).La chaîne et le format doivent être des chaînes.

Par exemple:

le Soutien de la %Z directive est fondée sur les valeurs contenues dans tznameet si daylight est vraie. Pour cette raison, il est spécifique à la plate-forme, sauf pour reconnaître UTC et GMT qui sont toujours connus (et sont considérés comme des fuseaux horaires non-heure d’été).

seules les directives spécifiées dans la documentation sont prises en charge., Parce questrftime() est implémenté par plate-forme, il peut parfois offrir plus de directives que celles répertoriées. Mais strptime() est indépendant de toute plateforme et ne prend donc pas nécessairement en charge toutes les directives disponibles qui ne sont pas documentées comme supportées.

classetime.struct_time

Le type de la valeur de temps de la séquence retournée par gmtime(),localtime() et strptime(). C’est un objet avec une interface namedtuple: les valeurs sont accessibles par index et par nom d’attribut., Les valeurs suivantes sont présentes:

notez que contrairement à la structure C, la valeur du mois est une plage de , not.

dans les appels àmktime(),tm_isdst peut être défini sur 1 lorsque l’heure daylightsavings est en vigueur, et 0 lorsqu’il ne l’est pas. Une valeur de -1 indique quececi n’est pas connu, et se traduira généralement par le remplissage de l’état correct.

Quand un tuple avec une longueur incorrecte est transmis à une fonction attend unstruct_time, ou ayant des éléments de type incorrect, unTypeError est soulevée.,

time.time() → float¶

renvoie le temps en secondes depuis l’époque sous la forme d’un nombre de points flottant. La date spécifique de l’époque et la gestion des secondes de pointe dépendent de la plate-forme.Sur Windows et la plupart des systèmes Unix, l’époque est le 1er janvier 1970,00:00:00 (UTC) et les secondes intercalaires ne sont pas comptées dans le timein secondes depuis l’époque. Ceci est communément appelé asUnix time.To découvrez quelle est l’époque sur une plate-forme donnée, regardezgmtime(0).,

notez que même si le temps est toujours renvoyé sous forme de nombre à virgule flottante, tous les systèmes ne fournissent pas le temps avec une meilleure précision que 1 seconde.Bien que cette fonction renvoie normalement des valeurs non décroissantes, elle peut renvoyer une valeur inférieure à celle d’un appel précédent si l’horloge système a été réglée entre les deux appels.

le nombre renvoyé par time()peut être converti dans un format plus commun (c’est-à-dire Année, Mois, Jour, Heure, etc.) en UTC en le passant à la fonctiongmtime()ou en heure locale en le passant à la fonctionlocaltime()., Dans les deux cas, un objetstruct_time est renvoyé, à partir duquel les composants de la date du calendrier peuvent être accédés en tant qu’attributs.

time.thread_time() → float¶

renvoie la valeur (en fractions de secondes) de la somme du temps système et userCPU du thread en cours. Il n’inclut pas le temps écoulé pendantle sommeil. Il est spécifique au thread par définition. Le point de référence de la valeur retournée est indéfini, de sorte que seule la différence entre les resultsof appels consécutifs dans le même thread est valide.,

disponibilité: systèmes Windows, Linux, Unix prenant en chargeCLOCK_THREAD_CPUTIME_ID.

nouveau dans la version 3.7.

time.thread_time_ns() → int¶

type thread_time() mais l’heure de retour que nanosecondes.

nouveau dans la version 3.7.

time.time_ns() → int¶

similaire àtime() mais renvoie le temps sous la forme d’un nombre entier de nanosecondes depuis l’époque.

nouveau dans la version 3.7.,

time.tzset()¶

Réinitialiser le temps des règles de conversion utilisé par les routines de la bibliothèque. L’environnementvariable TZ spécifie comment cela se fait., Il définira également les variablestzname (à partir de la variable d’environnement TZ), timezone (non-DSTseconds à L’ouest de UTC), altzone (secondes DST à l’ouest de UTC) et daylight(à 0 si ce fuseau horaire n’a pas de règles d’heure d’été, ou tononzero s’il y a une heure, passée, présente ou future lorsque l’heure d’été apparaît).

disponibilité: Unix.,

Remarque

bien que dans de nombreux cas, la modification de la variable d’environnement TZpuisse affecter la sortie de fonctions telles quelocaltime()sans appeler tzset(), ce comportement ne doit pas être invoqué.

la variable d’environnementTZ ne doit contenir aucun espace.,

Le format standard de la balise TZ variable d’environnement (whitespaceadded pour plus de clarté):

std offset , end]]]

Où les composants sont les suivants:

stdetdst

Trois ou plusieurs caractères alphanumériques donner le fuseau horaire abréviations. Ces bepropagated dans le temps.tzname

offset

Le décalage est de la forme: ± hh]. Cela indique la valeur ajoutée à l’heure locale pour arriver à UTC., S’il est précédé d’un » -« , le fuseau horaire est à l’est du méridien principal; sinon, il est à l’Ouest. Si aucun décalage ne suit, l’heure d’été est supposée avoir une heure d’avance sur l’heure normale.

start, end

Indique quand changer de l’heure d’été. Le format de thestart et les dates de fin sont l’une des opérations suivantes:

Jn

Le jour Julien n (1 <= n <= 365). Les jours bissextiles ne sont pas comptés, donc danstoutes les années le 28 février est le jour 59 et le 1er Mars est le jour 60.,

n

La base zéro jour Julien (0 <= n <= 365). Les jours bissextiles sont comptés, etil est possible de se référer au 29 février.

Mm.n.d

time a le même format qu’ offset sauf qu’aucun signe de début(‘-‘ ou ‘+’) est autorisée. La valeur par défaut, si l’heure n’est pas donnée, est 02:00:00.

sur de nombreux systèmes Unix (y compris *BSD, Linux, Solaris et Darwin), il est plus pratique d’utiliser la base de données zoneinfo (tzfile(5)) du système pour spécifier les règles de fuseau horaire., Pour ce faire, définissez l’environnementTZ variable sur le chemin du fichier de données de fuseau horaire requis, par rapport à la racine de la base de données de fuseau horaire des systèmes ‘zoneinfo’, généralement située à/usr/share/zoneinfo. Par exemple, la balise 'US/Eastern','Australia/Melbourne', 'Egypt' ou 'Europe/Amsterdam'.

>>> os.environ = 'US/Eastern'>>> time.tzset()>>> time.tzname('EST', 'EDT')>>> os.environ = 'Egypt'>>> time.tzset()>>> time.tzname('EET', 'EEST')