Função DATE_PART

DATE_PART extrai os valores de parte da data de uma expressão. DATE_PART é sinônimo da função PGDATE_PART.

Sintaxe

DATE_PART(datepart, {date|timestamp})

Argumentos

datepart

O literal ou a string de um identificador da parte específica do valor de data (por exemplo, ano, mês ou dia) sobre a qual a função atua. Para ter mais informações, consulte Partes da data para funções de data ou de timestamp.

{date|timestamp}

Uma coluna de data ou timestamp ou uma expressão que se converta implicitamente em uma data ou timestamp. A coluna ou expressão em date ou timestamp deve conter a parte da data especificada em datepart.

Tipo de retorno

DOUBLE

Exemplos

O nome padrão da coluna para a função DATE_PART é pgdate_part.

O exemplo a seguir encontra o minuto de um literal do carimbo de data/hora.

SELECT DATE_PART(minute, timestamp '20230104 04:05:06.789');
            
pgdate_part
-----------
         5		

O exemplo a seguir encontra o número da semana de um literal do carimbo de data/hora. O cálculo do número da semana segue o padrão ISO 8601. Para obter mais informações, consulte ISO 8601 na Wikipédia.

SELECT DATE_PART(week, timestamp '20220502 04:05:06.789');
            
pgdate_part
-----------
         18		

O exemplo a seguir encontra o dia do mês de um literal do carimbo de data/hora.

SELECT DATE_PART(day, timestamp '20220502 04:05:06.789');
            
pgdate_part
-----------
         2

O exemplo a seguir encontra o dia da semana de um literal do carimbo de data/hora. O cálculo do número da semana segue o padrão ISO 8601. Para obter mais informações, consulte ISO 8601 na Wikipédia.

SELECT DATE_PART(dayofweek, timestamp '20220502 04:05:06.789');
            
pgdate_part
-----------
         1

O exemplo a seguir encontra o século de um literal do carimbo de data/hora. O cálculo do número do século segue o padrão ISO 8601. Para obter mais informações, consulte ISO 8601 na Wikipédia.

SELECT DATE_PART(century, timestamp '20220502 04:05:06.789');
            
pgdate_part
-----------
         21

O exemplo a seguir encontra o milênio de um literal de timestamp. O cálculo do milênio segue o padrão ISO 8601. Para obter mais informações, consulte ISO 8601 na Wikipédia.

SELECT DATE_PART(millennium, timestamp '20220502 04:05:06.789');
            
pgdate_part
-----------
         3

O exemplo a seguir encontra a quantidade de microssegundos de um literal de timestamp. O cálculo do número do microssegundos segue o padrão ISO 8601. Para obter mais informações, consulte ISO 8601 na Wikipédia.

SELECT DATE_PART(microsecond, timestamp '20220502 04:05:06.789');
            
pgdate_part
-----------
    789000

O exemplo a seguir encontra o mês de um literal da data.

SELECT DATE_PART(month, date '20220502');
            
pgdate_part
-----------
         5

O exemplo a seguir aplica a função DATE_PART à uma coluna em uma tabela.

SELECT date_part(w, listtime) AS weeks, listtime
FROM listing 
WHERE listid=10
            

weeks |      listtime
------+---------------------
 25   | 2008-06-17 09:44:54
(1 row)

Você pode nomear partes da data completamente ou abreviá-las; nesse caso, w representa semanas.

A parte da data do dia da semana retorna um número inteiro de 0 a 6, começando com domingo. Use DATE_PART com dow (DAYOFWEEK) para visualizar eventos em um sábado.

SELECT date_part(dow, starttime) AS dow, starttime 
FROM event
WHERE date_part(dow, starttime)=6
ORDER BY 2,1;     

 dow |      starttime
-----+---------------------
   6 | 2008-01-05 14:00:00
   6 | 2008-01-05 14:00:00
   6 | 2008-01-05 14:00:00
   6 | 2008-01-05 14:00:00
...
(1147 rows)