time.localtime(), gmtime(), mktime(), asctime(), ctime() în Python

time.localtime([secunde])
time.gmtime([secunde])
time.mktime(struct_time)
time.asctime([struct_time])
time.ctime([secunde])

Ce face time.localtime(), gmtime(), mktime(), asctime(), ctime()

localtime(ts) transformă un timestamp în struct_time pe ora locală, iar gmtime(ts) pe UTC; fără argument, folosesc momentul curent. mktime(t) face drumul invers pentru ora locală (pentru UTC există calendar.timegm).

asctime(t) și ctime(ts) returnează un text fix, de forma Thu Jan 1 00:00:00 1970. Rezultatele cu ora locală depind de fusul orar al calculatorului; în exemplu, fusul este setat explicit cu tzset().

Parametri

Parametru	Descriere
secunde	Opțional. Timestamp-ul. Implicit momentul curent.
struct_time	Pentru mktime/asctime: momentul descompus.

Ce returnează

struct_time, float (mktime) sau text.

Exemple

Exemplul 1: UTC față de ora României

import os, time
os.environ["TZ"] = "Europe/Bucharest"
time.tzset()
ts = 1792411200
print(time.gmtime(ts).tm_hour, time.localtime(ts).tm_hour, time.localtime(ts).tm_isdst)
print(time.asctime(time.gmtime(0)))
print(time.ctime(ts))
print(time.mktime(time.localtime(ts)) == ts)

Rezultat

12 15 1
Thu Jan  1 00:00:00 1970
Mon Oct 19 15:00:00 2026
True

Greșeli frecvente

• Dai lui mktime un struct_time obținut cu gmtime: mktime îl interpretează ca oră locală și rezultatul diferă cu decalajul fusului orar.

Comenzi înrudite

• time.strftime(), time.strptime() și struct_time: Formatarea și citirea datelor în modulul time, cu structura struct_time.
• time.tzset(): Reîncarcă setările de fus orar după variabila de mediu TZ.
• timestamp() și fromtimestamp(): Conversia între date și timestamp-uri Unix (secunde de la 1 ianuarie 1970 UTC).