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

TypeError: Object of type datetime is not JSON serializable

Pe scurt

`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

Greșit
PYTHON
import json
from datetime import date
comanda = {"id": 7, "data": date(2025, 3, 1)}
print(json.dumps(comanda))
Corect
PYTHON
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ă

Greșit
PYTHON
import json
etichete = {"nou", "redus"}
json.dumps({"etichete": etichete})
Corect
PYTHON
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

Greșit
PYTHON
import json
class Produs:
    def __init__(self, nume):
        self.nume = nume
json.dumps(Produs("pix"))
Corect
PYTHON
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ă tu

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

Codul care dă eroarea
PYTHON
import json
from datetime import date

factura = {"numar": 42, "emisa": date(2025, 3, 1), "total": 300}
print(json.dumps(factura))
După reparație, programul afișează
{"numar": 42, "emisa": "2025-03-01", "total": 300}
Indiciu

Obiectele date au o metodă care întoarce data ca text AAAA-LL-ZZ.

Alte forme ale mesajului

  • TypeError: Object of type date is not JSON serializable
  • TypeError: Object of type Decimal is not JSON serializable
  • TypeError: Object of type set is not JSON serializable
  • TypeError: 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 cu date.fromisoformat().
  • Pentru cazuri rapide, json.dumps(date, default=str) transformă orice valoare necunoscută în text.
  • Pentru obiecte proprii, folosește dataclasses.asdict sau 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

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