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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O coloană de date pandas are un singur fus orar pentru toate valorile. Când textele conțin decalaje diferite (de exemplu 2024-01-05 10:30+02:00 și 2024-07-05 10:30+03:00, cum se întâmplă în România din cauza orei de vară), pandas nu poate alege unul singur fără să schimbe orele. În pandas 3 se oprește și îți cere să alegi explicit: totul în UTC.
Cu utc=True fiecare moment e convertit corect în UTC, iar coloana are un singur fus. Dacă vrei să afișezi ora locală, convertești apoi întreaga coloană cu tz_convert, care ține cont de ora de vară.
În pandas 2 aceeași situație dădea un avertisment și o coloană object cu valori amestecate, care cădea mai târziu la .dt. Exporturile din API-uri și loguri au des acest format.
De ce apare: cauzele frecvente
1Ora de vară în date exportate cu decalaj
pd.to_datetime(["2024-01-05 10:30+02:00", "2024-07-05 10:30+03:00"])pd.to_datetime(["2024-01-05 10:30+02:00", "2024-07-05 10:30+03:00"], utc=True)utc=True transformă fiecare moment în UTC, ținând cont de decalajul lui.
2Amestec de Z și decalaje
pd.to_datetime(df["creat"]) # "...Z" și "...+02:00"pd.to_datetime(df["creat"], utc=True).dt.tz_convert("Europe/Bucharest")După conversia în UTC, tz_convert dă ora locală pentru fiecare moment.
3Comparații cu momente fără fus orar
pd.to_datetime(df["creat"], utc=True) > pd.Timestamp("2024-06-01")pd.to_datetime(df["creat"], utc=True) > pd.Timestamp("2024-06-01", tz="UTC")După utc=True coloana are fus orar, deci și valoarea cu care o compari trebuie să aibă.
Repară eroarea, direct în pagină
Codul de mai jos citește momentele unor comenzi exportate cu fus orar (ora României, iarna +02:00 și vara +03:00), iar pd.to_datetime dă ValueError: Mixed timezones detected. Repară conversia ca să afișeze ora în UTC a fiecărei comenzi.
import pandas as pd
df = pd.DataFrame({"creat": ["2024-01-05 10:30+02:00", "2024-07-05 10:30+03:00", "2024-12-01 08:00+02:00"]})
df["creat"] = pd.to_datetime(df["creat"])
print(df["creat"].dt.hour.tolist())[8, 7, 6]
Indiciu
Cere conversia tuturor momentelor în UTC cu utc=True.
Reparația
import pandas as pd
df = pd.DataFrame({"creat": ["2024-01-05 10:30+02:00", "2024-07-05 10:30+03:00", "2024-12-01 08:00+02:00"]})
df["creat"] = pd.to_datetime(df["creat"], utc=True)
print(df["creat"].dt.hour.tolist())De ce merge
Momentele au două decalaje diferite, +02:00 și +03:00, iar o coloană pandas poate avea un singur fus orar. Cu utc=True fiecare moment e transformat în UTC: 10:30+02:00 devine 08:30, 10:30+03:00 devine 07:30, iar 08:00+02:00 devine 06:00. Orele UTC sunt deci 8, 7 și 6.
Alte forme ale mesajului
ValueError: Tz-aware datetime.datetime cannot be converted to datetime64 unless utc=TrueFutureWarning: In a future version of pandas, parsing datetimes with mixed time zones will raise an error unless `utc=True`.
Cum o eviți pe viitor
- La date din API-uri, loguri sau exporturi cu fus orar, folosește mereu
utc=True. - Calculele și comparațiile fă-le în UTC, iar conversia în ora locală doar la afișare.
- Pentru ora României folosește
"Europe/Bucharest", nu un decalaj fix: ține cont de ora de vară. - Nu amesteca momente cu și fără fus orar în aceeași analiză.
Întrebări frecvente
Pierd informație cu utc=True?
Nu. Momentul e același, doar scris în UTC. Decalajul original îl poți reconstitui cu tz_convert pentru zona dorită.
Cum scap complet de fusul orar?
După conversie, .dt.tz_localize(None) scoate fusul și păstrează ora din zona curentă. E util pentru exporturi în Excel, care nu acceptă fus orar.
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: time data "13.03.2024" doesn't match format "%m.%d.%Y" pd.to_datetime a ghicit formatul datelor după prima valoare (aici lună.zi.an, ca în engleză) și s-a oprit la o dată care nu se potrivește, 13.03.2024. Spune explicit formatul românesc: pd.to_datetime(s, format="%d.%m.%Y"), sau folosește dayfirst=True. 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.
