

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# EXTRACT-Funktion in Amazon QLDB
<a name="ql-functions.extract"></a>

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `EXTRACT` Funktion, um den Ganzzahlwert eines bestimmten Datums- oder Zeitabschnitts aus einem bestimmten Zeitstempel zurückzugeben.

## Syntax
<a name="ql-functions.extract.syntax"></a>

```
EXTRACT ( datetimepart FROM timestamp )
```

## Argumente
<a name="ql-functions.extract.arguments"></a>

*datetimepart*  
Der Datums- oder Uhrzeitteil, den die Funktion extrahiert. Bei diesem Parameter kann es sich um einen der Folgenden handeln:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`
+ `timezone_hour`
+ `timezone_minute`

*timestamp*  
Der Feldname oder Ausdruck des Datentyps `timestamp`, aus dem die Funktion extrahiert. Wenn dieser Parameter ein unbekannter Typ (`NULL` oder `MISSING`) ist, gibt die Funktion `NULL` zurück.  
Ein Ion-Zeitstempel-Literalwert kann mit Backticks () bezeichnet werden. ``...`` Formatierungsdetails und Beispiele für Zeitstempelwerte finden Sie unter [Zeitstempel](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) im Amazon Ion-Spezifikationsdokument.

## Rückgabetyp
<a name="ql-functions.extract.return-type"></a>

`int`

## Beispiele
<a name="ql-functions.extract.examples"></a>

```
EXTRACT(YEAR FROM `2010-01-01T`)                           -- 2010
EXTRACT(MONTH FROM `2010T`)                                -- 1 (equivalent to 2010-01-01T00:00:00.000Z)
EXTRACT(MONTH FROM `2010-10T`)                             -- 10
EXTRACT(HOUR FROM `2017-01-02T03:04:05+07:08`)             -- 3
EXTRACT(MINUTE FROM `2017-01-02T03:04:05+07:08`)           -- 4
EXTRACT(TIMEZONE_HOUR FROM `2017-01-02T03:04:05+07:08`)    -- 7
EXTRACT(TIMEZONE_MINUTE FROM `2017-01-02T03:04:05+07:08`)  -- 8

-- Runnable statements
SELECT EXTRACT(YEAR FROM `2010-01-01T`) FROM << 0 >> -- 2010
SELECT EXTRACT(MONTH FROM `2010T`) FROM << 0 >>      -- 1
```

## Verwandte Funktionen
<a name="ql-functions.extract.related"></a>
+ [DATE\$1ADD](ql-functions.date_add.md)
+ [DATE\$1DIFF](ql-functions.date_diff.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)
+ [UTCNOW](ql-functions.utcnow.md)