...
Eroare Python pentru analiza datelor · Date calendaristice

TypeError: Cannot convert tz-naive timestamps, use tz_localize to localize

Pe scurt

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

Greșit
PYTHON
df["ora_ro"] = df["ora_utc"].dt.tz_convert("Europe/Bucharest")
Corect
PYTHON
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

Greșit
PYTHON
pd.Timestamp("2024-05-01 08:00").tz_convert("UTC")
Corect
PYTHON
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

Greșit
PYTHON
s = pd.to_datetime(df["moment"])  # "2024-05-01T08:00:00" (în UTC)
s.dt.tz_convert("Europe/Bucharest")
Corect
PYTHON
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ă tu

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.

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

Adaugă .dt.tz_localize("UTC") înainte de .dt.tz_convert(...).

Alte forme ale mesajului

  • TypeError: Cannot convert tz-naive Timestamp, use tz_localize to localize
  • TypeError: 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 de tz_localize sau tz_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

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