DESCRIPTION.

Retourne un tuple ( ) avec les attributs du type de l'horloge donnée.

SYNTAXE.

Valeur = time.get_clock_info ( horloge )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

time.ctime ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

horloge ⇨ type de l'horloge [ optionnel ]

REMARQUES.

horloge doit être un str ( ) valide ayant comme valeur un type d'horloge.

Les types valides d'horloges disponibles sont : "monotonic" ; "perf_counter" ; "process_time" ; "thread_time" et "time".

Le type d'horloge "clock" est obsolète depuis Python 3.8, et ne doit donc plus être utilisé. Il est donné ici pour des raisons de compréhensions pour des scripts écrits avec les versions Python 3.7 et antérieurs. Toute utilisation de ce type d'horloge avec les version de Python 3.8 et supérieures lèveront une exception.

Les attributs retournés, et leurs valeurs possibles, sont :

- adjustable vaut True si le type de l'horloge est modifiable sinon False ;

- implementation donne le nom de la fonction permettant de connaitre la valeur de l'horloge ;

- monotonic vaut True si le type de l'horloge ne peut pas revenir en arrière sinon False ;

- resolution donne la résolution du type de l'horloge en secondes.

Pour rappel, les types d’horloges, et les fonctions permettant de lire leur valeur, sont les suivants :

- "clock", était associé à la méthode time.clock ( ), la valeur retournée dépendait de l'O.S. ;

- "monotonic", associé à la méthode time.monotonic ( ), ne peut pas revenir en arrière ;

- "perf_counter", associé à la méthode time.perf_counter ( ), mesure des courtes durées avec une grande précision ;

 - "process_time", associé à la méthode time.process_time ( ), retourne le temps d'utilisation du CPU et de l'utilisateur ;

 - "thread_time", associé à la méthode time.thread_time ( ), retourne le temps d'exécution du processus en cour ;

- "time", associé à la méthode time.time ( ), retourne le nombre de ecoudes écoulées depuis epoch.

Pour plus de précisions sur chaque type d'horloge, consultez la page de la méthode qui lui est associées.

Python nomme epoch la moment 0, c'est á dire le point d'origine du temps du système informatique hôte. Ce point de départ dépend de l'environnent (machine, OS, ...) mais équivaut, généralement, au 01 / 01 / 1970 à 00:00:00. Pour connaître l'origine temporelle de votre système utilisez time.ctime ( 0 ).

Le format date/heure retournée peut varier selon les spécificités de l'environnent su système.

EXEMPLES.

import time

print ( time.get_clock_info ( "clock" ) )

retournait namespace(adjustable=False, implementation='QueryPerformanceCounter()', monotonic=True, resolution=1e-07)

print ( time.get_clock_info ( "monotonic" ) )

retourne namespace(adjustable=False, implementation='GetTickCount64()', monotonic=True, resolution=0.015625)

print ( time.get_clock_info ( "perf_counter" ) )

namespace(adjustable=False, implementation='QueryPerformanceCounter()', monotonic=True, resolution=1e-07)

print ( time.get_clock_info ( "process_time" ) )

retourne namespace(adjustable=False, implementation='GetProcessTimes()', monotonic=True, resolution=1e-07)

print ( time.get_clock_info ( "thread_time" ) )

retourne namespace(adjustable=False, implementation='GetThreadTimes()', monotonic=True, resolution=1e-07)

print ( time.get_clock_info ( "time" ) )

retourne namespace(adjustable=True, implementation='GetSystemTimeAsFileTime()', monotonic=False, resolution=0.015625)