DESCRIPTION.

Retourne les composants de la structure du moment, date-heure locale, correspondant au nombre de secondes donné.  

SYNTAXE.

Valeur = time.localtime ( secondes )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

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

secondes ⇨ nombre de secondes depuis le moment 0 [ optionnel ]

REMARQUES.

secondes doit être un int ( ). voire un float ( ).

La méthode time.localtime ( ) calcule la date et l'heure entre epoch et le nombre de secondes écoulées sur le système de l'environnement, c'est-à-dire l'heure locale. Pour connaitre la date et l'heure du système GMT/UTC, heure universelle terrestre, il faut utiliser la méthode time.gmtime ( ).

La structure d'une date est composée des 9 éléments suivant :

- l'année, 4 chiffres entre 0000 et 9999, identifié par tm_year ;

- le mois, 2 chiffres entre 1 et 12, identifiée par tm_mon ;

- le jour, 2 chiffres entre 1 et 31, identifié par tm_mday ;

- l'heure, 2 chiffres entre 0 et 23, identifiée par tm_hour ;

- la minute, 2 chiffres entre 0 et 59, identifiée par tm_min ;

- la seconde, 2 chiffres entre 0 et 59, identifiée par tm_sec ;

- le jour de la semaine, 1 chiffre entre 0 (pour lundi) et 6 (pour dimanche), identifié par tm_wday ;

- le quantième jour de l'année, 3 chiffres entre 000 et 366, identifié par tm_yday ;

- l'heure d'été, 1 chiffre avec 0 (pour heure d'hiver), 1 (pour heure d'été), ou -1 (pour non connu), identifié par tm_isdst ;

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.localtime ( 0 ).

Certains systèmes ne peuvent pas gérer : 

- les temps négatifs, c'est-à-dire avant epoch ; 

- les temps futurs lointains, en général après 2038 ;

- le fractions de seconde, exprimées par un float ( ) ;

- ou plusieurs de ces cas.

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

time.localtimemktime ( ) est la fonction inverse de time.mktime ( ).

Si secondes est omis la méthode time.localtime ( ) retourne les données correspondantes au moment (date/heure) actuel du système.

EXEMPLES.

import time

print ( time.localtime ( ) ) retourne time.struct_time(tm_year=2019, tm_mon=11, tm_mday=20, tm_hour=14, tm_min=7, tm_sec=4, tm_wday=2, tm_yday=324, tm_isdst=0).

print ( time.localtime ( 0 ) ) retourne time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=3, tm_yday=1, tm_isdst=0).

print ( type ( time.localtime ( 0 ) ) ) retourne <class 'time.struct_time'>.

print ( time.localtime ( 1_234_567 ) ) retourne time.struct_time(tm_year=1970, tm_mon=1, tm_mday=15, tm_hour=6, tm_min=56, tm_sec=7, tm_wday=3, tm_yday=15, tm_isdst=0).

print ( time.localtime ( 10**20 ) ) retourne OverflowError: timestamp out of range for platform time_t.

print ( time.gmtime ( 3.14 ) ) retourne time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=3, tm_wday=3, tm_yday=1, tm_isdst=0).

print ( time.localtime ( -1 ) ) retourne time.struct_time(tm_year=1969, tm_mon=12, tm_mday=31, tm_hour=23, tm_min=59, tm_sec=59, tm_wday=2, tm_yday=365, tm_isdst=0).

kactuel = time.localtime ( )

for kelement in kactuel : print ( kelement , end = " " ) 

retourne, par exemple, 2023 3 26 15 16 12 6 85 0 .

import time

while True :

ksecondes = input ( "Indiquez un nombre de secondes s.v.p. ... " )

try : print ( time.localtime ( int ( ksecondes ) ) )

except : print ( "Erreur : saisie non valide." )

if input ( "Un autre (O ou N) ?" ).lower ( ) == "n" : break

retourne, par exemple,

Indiquez un nombre de secondes s.v.p. ... 17051994

e.struct_time(tm_year=1970, tm_mon=7, tm_mday=17, tm_hour=9, tm_min=39, tm_sec=54, tm_wday=4, tm_yday=198, tm_isdst=0)

Un autre (O ou N) ?n

>>>