Fonction DATE_PART

DATE_PART extrait des valeurs date part d’une expression. DATE_PART est un synonyme de la fonction PGDATE_PART.

Syntaxe

DATE_PART(datepart, {date|timestamp})

Arguments

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 de plus amples informations, veuillez consulter Parties de date pour les fonctions de date ou d'horodatage.

{date|timestamp}

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

DOUBLE

Exemples

Le nom de colonne par défaut pour la fonction DATE_PART est pgdate_part.

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.

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 calcul du numéro de semaine est conforme à la norme ISO 8601. Pour plus d'informations, consultez la page Wikipédia ISO 8601.

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.

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.

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.

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_PART à 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_PART 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)