EXTRACT() - Bestandteile eines Zeitwertes extrahieren

Funktionsgruppe: Numerische Funktion

EXTRACT() selektiert den angegebenen Bestandteil aus einem Zeitwert. EXTRACT() orientiert sich dabei am Gregorianischen Kalender, auch bei Daten vor dessen Einführung am 15.10.1582.

---

EXTRACT ( bestandteil FROM ausdruck )

bestandteil ::= { YEAR | MONTH | DAY | HOUR | MINUTE | SECOND |

                YEAR_OF_WEEK | WEEK_OF_YEAR | DAY_OF_WEEK | DAY_OF_YEAR }

---

bestandteil

Angabe des Bestandteils. Zulässige Eingaben sind:

YEAR	selektiert das Jahr eines Zeitstempels oder Datums, z.B. 2013
MONTH	selektiert den Monat des Jahres eines Zeitstempels oder Datums, z.B. 2 für Februar
DAY	selektiert den Tag des Monats eines Zeitstempels oder Datums, z.B. 25
HOUR	selektiert die Stunde des Tages eines Zeitstempels oder einer Uhrzeit, z.B. 23
MINUTE	selektiert die Minute der Stunde eines Zeitstempels oder einer Uhrzeit, z.B. 58
SECOND	selektiert die Sekunde der Minute eines Zeitstempels oder einer Uhrzeit, z.B. 35.765
YEAR_OF_WEEK	bestimmt das Jahr in dem die Woche eines Zeitstempels oder Datums liegt, z.B. 2013
WEEK_OF_YEAR	bestimmt die Woche des Jahres eines Zeitstempels oder Datums, z.B. 52
DAY_OF_WEEK	bestimmt den Tag der Woche eines Zeitstempels oder Datums, z.B. 3 für Mittwoch
DAY_OF_YEAR	bestimmt den Tag des Jahres eines Zeitstempels oder Datums, z.B. 365

ausdruck

Zeitwerte-Ausdruck. Zulässige Typen sind:

• • • • TIMESTAMP ist bei jedem bestandteil zulässig

      • TIME bei bestandteil HOUR, MINUTE oder SECOND

      • DATE bei bestandteil YEAR, MONTH, DAY, YEAR_OF_WEEK, WEEK_OF_YEAR, DAY_OF_WEEK oder DAY_OF_YEAR

ausdruck darf kein multipler Wert mit Dimension > 1 sein.

Ergebnis

Wenn ausdruck den NULL-Wert ergibt, ist das Ergebnis der NULL-Wert.

Sonst:

Der entsprechende numerische Wert.

Datentyp:

DECIMAL(1,0) DECIMAL(2,0) DECIMAL(3,0) DECIMAL(4,0) DECIMAL(5,3)

bei bestandteil DAY_OF_WEEK bei bestandteil MONTH, DAY, HOUR, MINUTE, WEEK_OF_YEAR bei bestandteil DAY_OF_YEAR bei bestandteil YEAR und YEAR_OF_WEEK bei bestandteil SECOND

Beispiele

Bestimmen der aktuellen Jahreszahl.

EXTRACT (YEAR FROM CURRENT_DATE)

Bestimmen des Tages im Jahr.

EXTRACT (DAY_OF_YEAR FROM DATE '<date>')

Bestimmen der aktuellen Sekunde.

EXTRACT (SECOND FROM CURRENT_TIME(3))