ERROR: unit "luna" not recognized for type timestamp with time zone
Funcțiile date_trunc și extract (sau date_part) primesc numele unității în engleză: year, month, week, day, hour, dow. Un nume în română (luna, an, zi) sau scris greșit dă această eroare. Folosește date_trunc('month', ...) sau extract(month FROM ...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul spune că unitatea cerută nu există pentru tipul respectiv (aici timestamp with time zone, adică timestamptz). Unitățile valide sunt în engleză: microseconds, milliseconds, second, minute, hour, day, week, month, quarter, year, decade, century, millennium, plus pentru extract: dow (ziua săptămânii, 0 = duminică), isodow (1 = luni), doy, epoch, isoyear, timezone.
La extract unitatea se scrie fără apostrofuri (extract(month FROM data)), iar la date_trunc între apostrofuri (date_trunc('month', data)). Rapoartele lunare corecte grupează după date_trunc('month', data), nu după extract(month ...), care ar amesteca aceeași lună din ani diferiți.
De ce apare: cauzele frecvente
1Unitate în română
SELECT date_trunc('luna', data), count(*) FROM comenzi GROUP BY 1;SELECT date_trunc('month', data), count(*) FROM comenzi GROUP BY 1;Numele unităților sunt în engleză.
2extract cu unitate greșită
SELECT extract(zi_saptamana FROM data) FROM comenzi;SELECT extract(isodow FROM data) FROM comenzi; -- 1 = luniisodow numerotează zilele de la luni (1) la duminică (7).
3Gruparea după luna fără an
SELECT extract(month FROM data), sum(total) FROM comenzi GROUP BY 1;SELECT date_trunc('month', data)::date, sum(total) FROM comenzi GROUP BY 1;Nu dă eroare, dar amestecă martie 2024 cu martie 2025; date_trunc păstrează și anul.
Repară eroarea, direct în pagină
Raportul lunar de vânzări dă unit "luna" not recognized for type date. Repar-o ca să afișeze prima zi a fiecărei luni (ca dată), numărul de comenzi și totalul, ordonate cronologic.
SELECT date_trunc('luna', data)::date AS luna, count(*) AS comenzi, sum(total) AS total
FROM comenzi
GROUP BY 1
ORDER BY 1;luna | comenzi | total ------------+---------+--------- 2025-02-01 | 1 | 75.00 2025-03-01 | 3 | 5147.40 (2 rânduri)
Indiciu
date_trunc primește unitatea în engleză.
Reparația
SELECT date_trunc('month', data)::date AS luna, count(*) AS comenzi, sum(total) AS total
FROM comenzi
GROUP BY 1
ORDER BY 1;De ce merge
date_trunc('month', data) aduce fiecare dată la prima zi a lunii ei, păstrând anul, iar ::date elimină ora. Gruparea după această valoare dă un rând pentru februarie (o comandă) și unul pentru martie (trei comenzi). Unitatea în română nu este recunoscută de PostgreSQL.
Alte forme ale mesajului
ERROR: unit "luna" not recognized for type date
Cum o eviți pe viitor
- Reține unitățile în engleză și diferența dintre
dowșiisodow. - Pentru rapoarte pe perioade, grupează după
date_trunc, care păstrează anul. - Pentru filtre pe perioade, folosește intervale pe coloana brută (
data >= ... AND data < ...), ca să rămână utilizabil indexul.
Întrebări frecvente
date_trunc pe timestamptz depinde de fus?
Da: trunchierea la zi sau lună se face în fusul sesiunii. Pentru rezultate stabile, setează fusul sau folosește varianta cu al treilea argument: date_trunc('day', ts, 'Europe/Bucharest').
Cum obțin numele lunii în română?
Cu to_char(data, 'TMMonth'), dacă serverul are lc_time setat pe română; altfel cu un CASE sau un tabel de traducere.
Erori înrudite
ERROR: time zone "Europe/Bucuresti" not recognized Numele fusului orar nu există în baza de fusuri a PostgreSQL. Pentru România, numele corect este Europe/Bucharest (în engleză). Verifică lista cu SELECT name FROM pg_timezone_names și evită abrevierile ambigue (EET, EEST) pentru calcule pe tot anul. ERROR: invalid input syntax for type interval: "1 luna" Textul nu e un interval valid. PostgreSQL înțelege unitățile doar în engleză (1 month, 2 days, 3 hours), nu în română (1 luna, 2 zile). Scrie intervalul în engleză, de exemplu interval '1 month', sau construiește-l cu make_interval(months => 1). ERROR: date/time field value out of range: "2025-02-30" Data are o componentă imposibilă: 30 februarie, luna 13, ora 25, sau ziua și luna sunt citite în altă ordine decât ai scris (12/31/2025 interpretat ca zi/lună). Corectează valoarea sau scrie datele în format ISO, AAAA-LL-ZZ, care nu depinde de setări. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
