TypeError: can't compare offset-naive and offset-aware datetimes
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
from datetime import datetime
expira = datetime.fromisoformat("2025-03-01T10:00:00+00:00")
if datetime.now() > expira:
print("expirat")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
from datetime import datetime, timezone
creat = datetime(2025, 3, 1, 8, 0)
acum = datetime.now(timezone.utc)
print(acum - creat)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
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)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ă 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.
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")Expirat: True Depășire: 2 zile
Indiciu
Dă-i lui datetime(...) și argumentul tzinfo=timezone.utc.
Reparația
from datetime import datetime, timezone
expira = datetime.fromisoformat("2025-03-01T00:00:00+00:00")
verificare = datetime(2025, 3, 3, tzinfo=timezone.utc)
print("Expirat:", verificare > expira)
print(f"Depășire: {(verificare - expira).days} zile")De ce merge
expira are fus orar (+00:00), iar verificare nu avea, așa că Python nu știa cum să le alinieze și refuza comparația. Cu tzinfo=timezone.utc, ambele date sunt în UTC, deci comparația și scăderea au sens: 3 martie e după 1 martie, cu 2 zile.
Alte forme ale mesajului
TypeError: can't subtract offset-naive and offset-aware datetimesTypeError: can't compare datetime.datetime to datetime.dateTypeError: 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
ValueError: time data '2024-13-01' does not match format '%Y-%m-%d' `datetime.strptime()` nu a putut citi textul cu formatul dat: ordinea zilei și a lunii e alta, separatorii diferă (`.` vs `-`), lipsesc sau sunt în plus ore, sau valoarea e imposibilă (luna 13). Potrivește exact formatul cu textul: `"01.03.2025"` se citește cu `"%d.%m.%Y"`. TypeError: Object of type datetime is not JSON serializable `json.dumps()` știe să transforme doar dicționare, liste, texte, numere, `True`/`False` și `None`. O dată calendaristică, un `Decimal`, un `set` sau un obiect al tău trebuie convertite întâi: `d.isoformat()`, `float(x)`, `list(s)`, sau `json.dumps(date, default=str)`. TypeError: '>' not supported between instances of 'str' and 'int' Compari un text cu un număr (`"18" > 5`), iar Python nu știe cum să le ordoneze. Transformă textul în număr cu `int()` sau `float()` înainte de comparație. La `sort()` sau `max()`, eroarea apare când lista amestecă texte și numere. Î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.
