Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función EXTRACT en Amazon QLDB
<a name="ql-functions.extract"></a>

**importante**  
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL.

En Amazon QLDB, use la función `EXTRACT` para devolver el valor entero de una fecha especificada o la parte de hora de una marca de tiempo determinada.

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

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

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

*datetimepart*  
La parte de fecha u hora que extrae la función. Este parámetro puede ser uno de los siguientes:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`
+ `timezone_hour`
+ `timezone_minute`

*timestamp*  
El nombre de campo o la expresión del tipo de datos `timestamp` del que se extrae la función. Si este parámetro es de tipo desconocido (`NULL` o `MISSING`), la función devuelve `NULL`.  
El valor literal de una marca de tiempo de Ion se puede indicar con comillas invertidas (``...``). Para obtener más detalles sobre formatos y ejemplos de valores de marcas de tiempo, consulte [Marcas de tiempo](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) en el documento de especificaciones de Amazon Ion.

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

`int`

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

## Funciones relacionadas
<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)