TypeError: Cannot convert tz-naive timestamps, use tz_localize to localize
Chemi tz_convert pe date fără fus orar (tz-naive), dar conversia are nevoie să știe din ce fus pornești. Spune întâi fusul datelor cu .dt.tz_localize("UTC") (sau fusul real al datelor), apoi convertește: .dt.tz_convert("Europe/Bucharest").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Datele fără fus orar (tz-naive) sunt doar o zi și o oră, fără să spună unde. tz_convert mută o oră dintr-un fus în altul, deci are nevoie de un punct de plecare. Pe date naive, pandas nu ghicește și îți spune ce lipsește: întâi tz_localize.
Cele două metode fac lucruri diferite:
tz_localize("UTC")etichetează orele existente cu un fus, fără să le schimbe (10:00 devine 10:00 UTC);tz_convert("Europe/Bucharest")mută orele etichetate în alt fus (10:00 UTC devine 12:00 iarna).
Greșeala inversă, tz_localize pe date care au deja fus, dă Already tz-aware, use tz_convert to convert.. Verifică fusul curent cu df["col"].dt.tz (None înseamnă naive).
De ce apare: cauzele frecvente
1Conversie direct pe date naive
df["ora_ro"] = df["ora_utc"].dt.tz_convert("Europe/Bucharest")df["ora_ro"] = df["ora_utc"].dt.tz_localize("UTC").dt.tz_convert("Europe/Bucharest")tz_localize spune că orele sunt în UTC, apoi tz_convert le poate muta în ora României.
2Un singur Timestamp naiv
pd.Timestamp("2024-05-01 08:00").tz_convert("UTC")pd.Timestamp("2024-05-01 08:00", tz="Europe/Bucharest").tz_convert("UTC")Fusul se poate da direct la creare, cu tz=.
3Citire fără fus, din text cu fus
s = pd.to_datetime(df["moment"]) # "2024-05-01T08:00:00" (în UTC)
s.dt.tz_convert("Europe/Bucharest")s = pd.to_datetime(df["moment"], utc=True)
s.dt.tz_convert("Europe/Bucharest")utc=True la citire face datele UTC (tz-aware) direct, gata de conversie.
Repară eroarea, direct în pagină
Serverul salvează momentele comenzilor în UTC, fără fus orar în date. Codul de mai jos vrea ora în fusul UTC+2, dar tz_convert dă TypeError: Cannot convert tz-naive timestamps, use tz_localize to localize. Repară-l ca să afișeze ora (fără minute) fiecărei comenzi în UTC+2.
import pandas as pd
from datetime import timezone, timedelta
utc2 = timezone(timedelta(hours=2))
df = pd.DataFrame({"moment": pd.to_datetime(["2024-01-10 08:15", "2024-01-10 21:40", "2024-01-11 23:05"])})
local = df["moment"].dt.tz_convert(utc2)
print(local.dt.hour.tolist())[10, 23, 1]
Indiciu
Adaugă .dt.tz_localize("UTC") înainte de .dt.tz_convert(...).
Reparația
import pandas as pd
from datetime import timezone, timedelta
utc2 = timezone(timedelta(hours=2))
df = pd.DataFrame({"moment": pd.to_datetime(["2024-01-10 08:15", "2024-01-10 21:40", "2024-01-11 23:05"])})
local = df["moment"].dt.tz_localize("UTC").dt.tz_convert(utc2)
print(local.dt.hour.tolist())De ce merge
Datele erau naive: pandas nu știa că orele sunt în UTC, deci nu avea de unde porni conversia. tz_localize("UTC") le etichetează ca UTC fără să le schimbe, iar tz_convert adaugă cele 2 ore: 8 devine 10, 21 devine 23, iar 23 trece de miezul nopții și devine 1, în ziua următoare. În aplicații reale ai folosi "Europe/Bucharest", care ține cont și de ora de vară.
Alte forme ale mesajului
TypeError: Cannot convert tz-naive Timestamp, use tz_localize to localizeTypeError: Already tz-aware, use tz_convert to convert.
Cum o eviți pe viitor
- Află sursa orelor (server în UTC, aplicație în ora locală) și localizează-le o singură dată, imediat după citire.
- Pentru date din API-uri și baze de date,
pd.to_datetime(..., utc=True)e de obicei alegerea sigură. - Lucrează intern în UTC și convertește în ora locală doar la afișare.
- Verifică
s.dt.tzînainte detz_localizesautz_convert.
Întrebări frecvente
Cum scot fusul orar, ca să rămână date naive?
s.dt.tz_localize(None) scoate eticheta și păstrează ora locală afișată. De obicei e nevoie de asta la export în Excel, care nu acceptă date cu fus orar.
De ce ora diferă cu 2 sau 3 ore?
România e la UTC+2 iarna și UTC+3 vara (ora de vară). tz_convert("Europe/Bucharest") aplică automat diferența corectă pentru fiecare dată.
Erori înrudite
TypeError: Cannot subtract tz-naive and tz-aware datetime-like objects Una dintre date are fus orar (de exemplu UTC, din texte cu Z sau +02:00), iar cealaltă nu, deci pandas nu le poate scădea sau compara. Adu-le la același fel: elimină fusul orar cu dt.tz_localize(None) (după dt.tz_convert la ora locală, dacă trebuie) sau adaugă-l celeilalte, cu tz="UTC". ValueError: Mixed timezones detected. Pass utc=True in to_datetime or tz='UTC' in DatetimeIndex to convert to a common timezone. Textele cu date au fusuri orare diferite (+02:00 iarna, +03:00 vara, sau Z) și pandas nu le poate pune într-o singură coloană. Scrie pd.to_datetime(..., utc=True), apoi, dacă vrei ora locală, .dt.tz_convert("Europe/Bucharest"). AttributeError: Can only use .dt accessor with datetimelike values Ai folosit .dt (month, year, day_name...) pe o coloană care conține texte, nu date calendaristice. read_csv nu convertește singur datele: transformă coloana cu pd.to_datetime(df["data"]) sau citește fișierul cu parse_dates=["data"]. Învață Python pentru analiza datelor de la zero, cu exerciții la fiecare lecție
Curs Data Analysis with Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
