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 EXTRACT dans Amazon QLDB
<a name="ql-functions.extract"></a>

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Dans Amazon QLDB, utilisez `EXTRACT` la fonction pour renvoyer la valeur entière d'une partie de date ou d'heure spécifiée à partir d'un horodatage donné.

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

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

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

*datetimepart*  
Partie de date ou d'heure extraite par la fonction. Ce paramètre peut avoir l'une des valeurs suivantes :  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`
+ `timezone_hour`
+ `timezone_minute`

*timestamp*  
Le nom du champ ou l'expression du type de données `timestamp` dont la fonction est extraite. Si ce paramètre est d'un type inconnu (`NULL`ou`MISSING`), la fonction est renvoyée`NULL`.  
Une valeur littérale d'horodatage ionique peut être indiquée par backticks (). ``...`` Pour obtenir des informations sur le formatage et des exemples de valeurs d'horodatage, consultez la section [Horodatages du document](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) de spécification Amazon Ion.

## Type de retour
<a name="ql-functions.extract.return-type"></a>

`int`

## Exemples
<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
```

## Fonctions associées
<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)