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)`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
JSON are doar câteva tipuri: obiect, listă, text, număr, boolean și null. Python le potrivește cu dict, list/tuple, str, int/float, bool și None. Pentru orice alt tip, json nu știe ce text să scrie și ridică TypeError, cu numele tipului în mesaj: datetime, date, Decimal, set, bytes, ObjectId, Produs.
De la Python 3.14, mesajul are și o notă cu locul exact (when serializing dict item 'data'). Apare des când salvezi rezultate din baze de date (date calendaristice, Decimal pentru bani), când trimiți răspunsuri dintr-un API sau când pui obiecte proprii în JSON. Ai două variante: convertești explicit valorile înainte, sau dai lui json.dumps o funcție default, apelată pentru fiecare valoare necunoscută.
De ce apare: cauzele frecvente
1Dată calendaristică într-un dicționar
import json
from datetime import date
comanda = {"id": 7, "data": date(2025, 3, 1)}
print(json.dumps(comanda))import json
from datetime import date
comanda = {"id": 7, "data": date(2025, 3, 1).isoformat()}
print(json.dumps(comanda))isoformat() transformă data în textul standard "2025-03-01", pe care JSON îl poate scrie.
2Set în loc de listă
import json
etichete = {"nou", "redus"}
json.dumps({"etichete": etichete})import json
etichete = {"nou", "redus"}
json.dumps({"etichete": sorted(etichete)})JSON nu are seturi. O listă (sortată, ca ordinea să fie stabilă) funcționează.
3Obiect propriu
import json
class Produs:
def __init__(self, nume):
self.nume = nume
json.dumps(Produs("pix"))import json
from dataclasses import dataclass, asdict
@dataclass
class Produs:
nume: str
json.dumps(asdict(Produs("pix")))asdict transformă un dataclass într-un dicționar, pe care JSON îl poate scrie.
Repară eroarea, direct în pagină
Codul de mai jos transformă o factură în JSON și dă TypeError: Object of type date is not JSON serializable. Transformă data în text standard ISO înainte de json.dumps, ca programul să afișeze {"numar": 42, "emisa": "2025-03-01", "total": 300}.
import json
from datetime import date
factura = {"numar": 42, "emisa": date(2025, 3, 1), "total": 300}
print(json.dumps(factura)){"numar": 42, "emisa": "2025-03-01", "total": 300}Indiciu
Obiectele date au o metodă care întoarce data ca text AAAA-LL-ZZ.
Reparația
import json
from datetime import date
factura = {"numar": 42, "emisa": date(2025, 3, 1).isoformat(), "total": 300}
print(json.dumps(factura))De ce merge
JSON nu are un tip pentru date calendaristice, iar modulul json nu știe ce text să scrie pentru un obiect date. isoformat() îl transformă în textul standard "2025-03-01", pe care JSON îl scrie ca orice alt text. La citire, date.fromisoformat() face drumul invers.
Alte forme ale mesajului
TypeError: Object of type date is not JSON serializableTypeError: Object of type Decimal is not JSON serializableTypeError: Object of type set is not JSON serializableTypeError: Object of type bytes is not JSON serializable
Cum o eviți pe viitor
- Convertește datele calendaristice cu
isoformat()și citește-le înapoi cudate.fromisoformat(). - Pentru cazuri rapide,
json.dumps(date, default=str)transformă orice valoare necunoscută în text. - Pentru obiecte proprii, folosește
dataclasses.asdictsau o metodăto_dict(). - În API-uri, folosește biblioteci care știu să serializeze aceste tipuri (FastAPI, pydantic).
Întrebări frecvente
Ce face default=str?
Îi spune lui json.dumps să apeleze str(valoare) pentru orice valoare pe care nu o știe. O dată devine "2025-03-01", un Decimal devine "12.50". E comod, dar la citire primești texte, nu tipurile inițiale.
De ce eroarea apare doar la unele înregistrări?
Probabil doar unele au câmpul problematic completat, de exemplu o dată de livrare care e None (serializabil) la comenzile nelivrate și datetime la cele livrate.
Erori înrudite
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) Ai dat lui `json.loads()` / `json.load()` un text care nu e JSON: un text gol, o pagină HTML (eroare 404/500 de la un API) sau un fișier gol. „line 1 column 1 (char 0)” înseamnă că problema e chiar de la primul caracter. Afișează textul primit înainte de parsare. 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. TypeError: write() argument must be str, not int Metoda `write()` a unui fișier deschis în mod text primește doar texte, iar tu i-ai dat un număr (sau o listă, un dicționar). Spre deosebire de `print`, `write` nu convertește singur. Scrie `f.write(str(x))` sau, mai bine, `f.write(f"{x}\n")`. Î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.
