...
Eroare Python · Date: JSON, text și date calendaristice

TypeError: can't compare offset-naive and offset-aware datetimes

Pe scurt

Compari (sau scazi) o dată-oră fără fus orar (`datetime.now()`) cu una care are fus orar (`datetime.now(timezone.utc)`, date din API-uri sau baze de date). Python nu știe cum să le alinieze. Fă-le pe amândouă „aware”, de preferat în UTC.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un datetime poate fi naive (fără informație de fus orar, tzinfo este None) sau aware (cu fus orar, de exemplu UTC sau Europe/Bucharest). Ora 10:00 naive poate însemna 10:00 în București, la Londra sau în UTC; Python nu ghicește. De aceea refuză să compare sau să scadă un naive cu un aware: rezultatul ar putea fi greșit cu câteva ore.

Mesajul are două forme: can't compare la <, >, ==-ul ordonat și sortare, și can't subtract offset-naive and offset-aware datetimes la scădere. Apare des când combini datetime.now() (naive) cu date din API-uri (ISO cu Z sau +02:00), din baze de date cu coloane „with time zone”, din pandas sau din datetime.fromisoformat("...+00:00").

De ce apare: cauzele frecvente

1now() comparat cu o dată din API

Greșit
PYTHON
from datetime import datetime
expira = datetime.fromisoformat("2025-03-01T10:00:00+00:00")
if datetime.now() > expira:
    print("expirat")
Corect
PYTHON
from datetime import datetime, timezone
expira = datetime.fromisoformat("2025-03-01T10:00:00+00:00")
if datetime.now(timezone.utc) > expira:
    print("expirat")

datetime.now(timezone.utc) dă ora curentă cu fus orar, comparabilă cu data din API.

2Dată naive care știi că e în UTC

Greșit
PYTHON
from datetime import datetime, timezone
creat = datetime(2025, 3, 1, 8, 0)
acum = datetime.now(timezone.utc)
print(acum - creat)
Corect
PYTHON
from datetime import datetime, timezone
creat = datetime(2025, 3, 1, 8, 0, tzinfo=timezone.utc)
acum = datetime.now(timezone.utc)
print(acum - creat)

Dacă știi fusul orar al unei date naive, atașează-l cu tzinfo= sau replace(tzinfo=...).

3Ora locală a utilizatorului

Greșit
PYTHON
from datetime import datetime
from zoneinfo import ZoneInfo
ora_locala = datetime(2025, 3, 1, 10, 0)
ora_utc = datetime(2025, 3, 1, 8, 0, tzinfo=ZoneInfo("UTC"))
print(ora_locala == ora_utc or ora_locala < ora_utc)
Corect
PYTHON
from datetime import datetime
from zoneinfo import ZoneInfo
ora_locala = datetime(2025, 3, 1, 10, 0, tzinfo=ZoneInfo("Europe/Bucharest"))
ora_utc = datetime(2025, 3, 1, 8, 0, tzinfo=ZoneInfo("UTC"))
print(ora_locala == ora_utc)

Cu fusul orar corect, 10:00 la București și 08:00 UTC sunt același moment.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos verifică dacă un abonament a expirat și dă TypeError: can't compare offset-naive and offset-aware datetimes, pentru că data de verificare nu are fus orar. Atașează fusul UTC datei verificare, ca programul să afișeze Expirat: True și Depășire: 2 zile.

Codul care dă eroarea
PYTHON
from datetime import datetime, timezone

expira = datetime.fromisoformat("2025-03-01T00:00:00+00:00")
verificare = datetime(2025, 3, 3)
print("Expirat:", verificare > expira)
print(f"Depășire: {(verificare - expira).days} zile")
După reparație, programul afișează
Expirat: True
Depășire: 2 zile
Indiciu

Dă-i lui datetime(...) și argumentul tzinfo=timezone.utc.

Alte forme ale mesajului

  • TypeError: can't subtract offset-naive and offset-aware datetimes
  • TypeError: can't compare datetime.datetime to datetime.date
  • TypeError: Cannot compare tz-naive and tz-aware datetime-like objects

Cum o eviți pe viitor

  • Lucrează intern doar cu date aware în UTC: datetime.now(timezone.utc).
  • Convertește la ora locală doar la afișare: d.astimezone(ZoneInfo("Europe/Bucharest")).
  • Când primești date naive din surse externe, află fusul orar și atașează-l imediat.
  • Evită datetime.utcnow(): întoarce o dată naive și e marcat ca învechit (deprecated) de la Python 3.12.

Întrebări frecvente

De ce == între naive și aware nu dă eroare?

Pentru egalitate, Python întoarce pur și simplu False când una e naive și cealaltă aware. Doar comparațiile de ordine (<, >) și scăderea dau eroare, pentru că acolo un răspuns greșit ar fi periculos.

Cum verific dacă o dată e naive sau aware?

Uită-te la d.tzinfo: dacă este None, data e naive. Afișată, o dată aware are și decalajul la final, de exemplu 2025-03-01 10:00:00+00:00.

Erori înrudite

← Toate erorile Python

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 de la zero, cu exerciții la fiecare lecție

Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.