...
Eroare PostgreSQL · Tipuri de date, operatori și conversii

ERROR: unit "luna" not recognized for type timestamp with time zone

Pe scurt

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ă

Greșit
SQL
SELECT date_trunc('luna', data), count(*) FROM comenzi GROUP BY 1;
Corect
SQL
SELECT date_trunc('month', data), count(*) FROM comenzi GROUP BY 1;

Numele unităților sunt în engleză.

2extract cu unitate greșită

Greșit
SQL
SELECT extract(zi_saptamana FROM data) FROM comenzi;
Corect
SQL
SELECT extract(isodow FROM data) FROM comenzi;  -- 1 = luni

isodow numerotează zilele de la luni (1) la duminică (7).

3Gruparea după luna fără an

Greșit
SQL
SELECT extract(month FROM data), sum(total) FROM comenzi GROUP BY 1;
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
SELECT date_trunc('luna', data)::date AS luna, count(*) AS comenzi, sum(total) AS total
FROM comenzi
GROUP BY 1
ORDER BY 1;
După reparație, programul afișează
    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ă.

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 și isodow.
  • 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

← Toate erorile PostgreSQL

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ță 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.