O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função DATE\$1PART
<a name="r_DATE_PART_function"></a>

DATE\$1PART extrai os valores de parte da data de uma expressão. DATE\$1PART é sinônimo da função PGDATE\$1PART. 

## Sintaxe
<a name="r_DATE_PART_function-synopsis"></a>

```
DATE_PART(datepart, {date|timestamp})
```

## Argumentos
<a name="r_DATE_PART_function-arguments"></a>

 *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 obter mais informações, consulte [Partes da data para funções de data ou de timestamp](r_Dateparts_for_datetime_functions.md). 

\$1*date*\$1*timestamp*\$1  
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
<a name="r_DATE_PART_function-return-type"></a>

DOUBLE

## Exemplos
<a name="r_DATE_PART_function-examples"></a>

O nome padrão da coluna para a função DATE\$1PART é `pgdate_part`.

 Para obter mais informações sobre os dados usados em alguns desses exemplos, consulte [Banco de dados de exemplo](c_sampledb.md).

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](https://en.wikipedia.org/wiki/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 do dia da semana é um inteiro de 0 a 6, começando no domingo.

```
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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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\$1PART à 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\$1PART 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)
```