Funktion EXTRACT

Die EXTRACT-Funktion gibt einen Datums- oder Uhrzeitanteil aus einem TIMESTAMP-, TIMESTAMPTZ-, TIME-, TIMETZ-, INTERVAL YEAR TO MONTH- oder INTERVAL DAY TO SECOND-Wert zurück. Beispiele hierfür sind ein Tag, Monat, Jahr, eine Stunde, Minute, Sekunde, Millisekunde oder Mikrosekunde aus einem Zeitstempel.

Syntax

EXTRACT(datepart FROM source)

Argumente

datepart

Das zu extrahierende Unterfeld eines Datums- oder Uhrzeitwerts, z. B. Tag, Monat, Jahr, Stunde, Minute, Sekunde, Millisekunde oder Mikrosekunde. Für mögliche Werte vgl. Datumsteile für Datums- oder Zeitstempelfunktionen.

source

Eine Spalte oder ein Ausdruck, der den Datentyp TIMESTAMP, TIMESTAMPTZ, TIME, TIMETZ, INTERVAL YEAR TO MONTH oder INTERVAL DAY TO SECOND ergibt.

Rückgabetyp

INTEGER, wenn der Quellwert den Datentyp TIMESTAMP, TIME, TIMETZ, INTERVAL YEAR TO MONTH oder INTERVAL DAY TO SECOND ergibt.

DOUBLE PRECISION, wenn der Wert source zum Datentyp TIMESTAMPTZ ausgewertet wird.

Beispiele mit TIMESTAMP

Im folgenden Beispiel werden die Wochennummern für Verkäufe bestimmt, bei denen der gezahlte Preis 10 000 USD oder mehr betrug. In diesem Beispiel werden die TICKET-Daten verwendet. Weitere Informationen finden Sie unter Beispieldatenbank.

select salesid, extract(week from saletime) as weeknum
from sales 
where pricepaid > 9999 
order by 2;

salesid | weeknum
--------+---------
 159073 |       6
 160318 |       8
 161723 |      26

Im folgenden Beispiel wird der Minutenwert aus einem Literal-Zeitstempel-Wert zurückgegeben.

select extract(minute from timestamp '2009-09-09 12:08:43');
            
date_part
-----------
8

Im folgenden Beispiel wird der Millisekundenwert aus einem Literal-Timestamp-Wert zurückgegeben.

select extract(ms from timestamp '2009-09-09 12:08:43.101');
            
date_part
-----------
101

Beispiele mit TIMESTAMPTZ

Im folgenden Beispiel wird der Jahreswert aus einem Literal-Timestamptz-Wert zurückgegeben.

select extract(year from timestamptz '1.12.1997 07:37:16.00 PST');
            
date_part
-----------
1997

Beispiele mit TIME

Die folgende Beispieltabelle TIME_TEST enthält eine Spalte TIME_VAL (Typ TIME) mit drei eingefügten Werten.

select time_val from time_test;
            
time_val
---------------------
20:00:00
00:00:00.5550
00:58:00

Im folgenden Beispiel werden die Minuten aus jedem time_val extrahiert.

select extract(minute from time_val) as minutes from time_test;
            
minutes
-----------
         0
         0
         58

Im folgenden Beispiel werden die Stunden aus jedem time_val extrahiert.

select extract(hour from time_val) as hours from time_test;
            
hours
-----------
         20
         0
         0

Im folgenden Beispiel wird Millisekunden aus einem Literalwert extrahiert.

select extract(ms from time '18:25:33.123456');
            
 date_part
-----------
     123

Beispiele mit TIMETZ

Die folgende Beispieltabelle TIMETZ_TEST enthält eine Spalte TIMETZ_VAL (Typ TIMETZ) mit drei eingefügten Werten.

select timetz_val from timetz_test;
            
timetz_val
------------------
04:00:00+00
00:00:00.5550+00
05:58:00+00

Im folgenden Beispiel werden die Stunden aus jedem timetz_val extrahiert.

select extract(hour from timetz_val) as hours from time_test;
            
hours
-----------
         4
         0
         5

Im folgenden Beispiel wird Millisekunden aus einem Literalwert extrahiert. Literale werden nicht in UTC konvertiert, bevor die Extraktion verarbeitet wurde.

select extract(ms from timetz '18:25:33.123456 EST');
            
 date_part
-----------
     123

Im folgenden Beispiel wird die Stunde der Zeitzonenabweichung von UTC aus einem Literal-Timetz-Wert zurückgegeben.

select extract(timezone_hour from timetz '1.12.1997 07:37:16.00 PDT');
            
date_part
-----------
-7

Beispiele mit INTERVALL YEAR TO MONTH und INTERVAL DAY TO SECOND

Im folgenden Beispiel wird der Tagesteil 1 von INTERVAL DAY TO SECOND extrahiert, der 36 Stunden definiert, was 1 Tag 12 Stunden entspricht.

select EXTRACT('days' from INTERVAL '36 hours' DAY TO SECOND)
  
 date_part
------------------
 1
 

Im folgenden Beispiel wird der Monatsteil 3 von YEAR TO MONTH extrahiert, der 15 Monate definiert, was 1 Jahr 3 Monaten entspricht.

select EXTRACT('month' from INTERVAL '15 months' YEAR TO MONTH)
  
 date_part
------------------
 3

Im folgenden Beispiel wird der Monatsteil 6 von 30 Monaten extrahiert, was 2 Jahren 6 Monaten entspricht.

select EXTRACT('month' from INTERVAL '30' MONTH)
   
 date_part
------------------
 6

Im folgenden Beispiel wird der Stundenteil 2 von 50 Stunden extrahiert, was 2 Tagen 2 Stunden entspricht.

select EXTRACT('hours' from INTERVAL '50' HOUR)
  
 date_part
------------------
 2

Im folgenden Beispiel wird der Minutenteil 11 von 1 Stunde 11 Minuten 11,123 Sekunden extrahiert.

select EXTRACT('minute' from INTERVAL '70 minutes 70.123 seconds' MINUTE TO SECOND)
  
 date_part
------------------
 11

Im folgenden Beispiel wird der Sekundenanteil 1.11 von 1 Tag 1 Stunde 1 Minute 1,11 Sekunden extrahiert.

select EXTRACT('seconds' from INTERVAL '1 day 1:1:1.11' DAY TO SECOND)
  
 date_part
------------------
 1.11

Im folgenden Beispiel wird die Gesamtzahl der Stunden in einem INTERVALL extrahiert. Jeder Teil wird extrahiert und zu einer Gesamtsumme hinzugefügt.

select EXTRACT('days' from INTERVAL '50' HOUR) * 24 + EXTRACT('hours' from INTERVAL '50' HOUR)
 
 ?column?
------------------
 50

Im folgenden Beispiel wird die Gesamtzahl der Sekunden in einem INTERVALL extrahiert. Jeder Teil wird extrahiert und zu einer Gesamtsumme hinzugefügt.

select EXTRACT('days' from INTERVAL '1 day 1:1:1.11' DAY TO SECOND) * 86400 + 
       EXTRACT('hours' from INTERVAL '1 day 1:1:1.11' DAY TO SECOND) * 3600 +
       EXTRACT('minutes' from INTERVAL '1 day 1:1:1.11' DAY TO SECOND) * 60 + 
       EXTRACT('seconds' from INTERVAL '1 day 1:1:1.11' DAY TO SECOND)
  
 ?column?
------------------
 90061.11