...
Eroare Python pentru analiza datelor · Date calendaristice

ValueError: Mixed timezones detected. Pass utc=True in to_datetime or tz='UTC' in DatetimeIndex to convert to a common timezone.

Pe scurt

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

Greșit
PYTHON
pd.to_datetime(["2024-01-05 10:30+02:00", "2024-07-05 10:30+03:00"])
Corect
PYTHON
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

Greșit
PYTHON
pd.to_datetime(df["creat"])  # "...Z" și "...+02:00"
Corect
PYTHON
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

Greșit
PYTHON
pd.to_datetime(df["creat"], utc=True) > pd.Timestamp("2024-06-01")
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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())
După reparație, programul afișează
[8, 7, 6]
Indiciu

Cere conversia tuturor momentelor în UTC cu utc=True.

Alte forme ale mesajului

  • ValueError: Tz-aware datetime.datetime cannot be converted to datetime64 unless utc=True
  • FutureWarning: 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

← Toate erorile Python pentru analiza datelor

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.