

 Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonction DATE\$1PART
<a name="r_DATE_PART_function"></a>

DATE\$1PART extrait des valeurs date part d’une expression. DATE\$1PART est un synonyme de la fonction PGDATE\$1PART. 

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

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

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

 *datepart*   
Un identifiant littéral ou une chaîne de caractères de la partie spécifique de la valeur de la date (par exemple, l’année, le mois ou le jour) sur laquelle la fonction opère. Pour plus d’informations, consultez [Parties de date pour les fonctions de date ou d’horodatage](r_Dateparts_for_datetime_functions.md). 

\$1*date*\$1*timestamp*\$1  
Une colonne de date, une colonne d’horodatage ou une expression qui se convertit implicitement en date ou en horodatage. La colonne ou l’expression en *date* ou *timestamp* doit contenir la partie date spécifiée dans *datepart*. 

## Type de retour
<a name="r_DATE_PART_function-return-type"></a>

DOUBLE

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

Le nom de colonne par défaut pour la fonction DATE\$1PART est `pgdate_part`.

 Pour obtenir plus d’informations sur les données utilisées dans certains de ces exemples, consultez [Exemple de base de données](c_sampledb.md).

L’exemple suivant recherche le jour de la semaine à partir d’un littéral d’horodatage. 

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

L’exemple suivant recherche le numéro de semaine à partir d’un littéral d’horodatage. Le calcul du numéro de semaine est conforme à la norme ISO 8601. Pour plus d’informations, consultez la page Wikipédia [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

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

L’exemple suivant recherche le jour du mois à partir d’un littéral d’horodatage.

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

L’exemple suivant recherche le jour de la semaine à partir d’un littéral d’horodatage. Le jour de la semaine est un nombre entier compris entre 0 et 6, en commençant par dimanche.

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

L’exemple suivant recherche le siècle à partir d’un littéral d’horodatage. Le calcul du siècle suit la norme ISO 8601. Pour plus d’informations, consultez la page Wikipédia [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

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

L’exemple suivant permet de trouver le millénaire à partir d’un littéral d’horodatage. Le calcul du millénaire suit la norme ISO 8601. Pour plus d’informations, consultez la page Wikipédia [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

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

L’exemple suivant permet de trouver les microsecondes à partir d’un littéral d’horodatage. Le calcul des microsecondes est conforme à la norme ISO 8601. Pour plus d’informations, consultez la page Wikipédia [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

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

L’exemple suivant recherche le mois à partir d’un littéral de date. 

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

L’exemple suivant applique la fonction DATE\$1PART à une colonne dans une table. 

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

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

Vous pouvez nommer les parties de date intégralement ou les abrégés ; dans ce cas, *w* est synonyme de semaines. 

Le jour de la semaine renvoie un nombre entier compris entre 0 et 6, en commençant par dimanche. Utilisez DATE\$1PART avec dow (DAYOFWEEK) afin d’afficher les événements d’un samedi. 

```
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)
```