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.

# Funciones de PartiQL en Amazon QLDB
<a name="ql-functions"></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.

PartiQL en Amazon QLDB admite las siguientes variantes integradas de funciones estándar de SQL.

**nota**  
QLDB no admite actualmente ninguna función SQL que no se incluya en esta lista.  
Esta referencia de funciones se basa en la documentación de PartiQL [Funciones integradas](https://github.com/partiql/partiql-lang-kotlin/blob/main/docs/wiki/documentation/Functions.md#built-in-functions).

**Propagación de tipo desconocido (nulo y ausente)**

A menos que se indique lo contrario, todas estas funciones propagan valores de argumentos nulos y ausentes. La *propagación* de `NULL` o `MISSING` se define como el retorno de `NULL` si algún argumento de la función es `NULL` o `MISSING`. A continuación se muestran algunos ejemplos de esta propagación.

```
CHAR_LENGTH(null)    -- null
CHAR_LENGTH(missing) -- null (also returns null)
```

## Funciones de agregación
<a name="ql-functions.aggregate"></a>
+ [AVG](ql-functions.avg.md)
+ [COUNT](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)

## Funciones condicionales
<a name="ql-functions.conditional"></a>
+ [COALESCE](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)
+ [NULLIF](ql-functions.nullif.md)

## Funciones de fecha y hora
<a name="ql-functions.date"></a>
+ [DATE\$1ADD](ql-functions.date_add.md)
+ [DATE\$1DIFF](ql-functions.date_diff.md)
+ [EXTRACT](ql-functions.extract.md)
+ [UTCNOW](ql-functions.utcnow.md)

## Funciones escalares
<a name="ql-functions.scalar"></a>
+ [TXID](ql-functions.txid.md)

## Funciones de cadena
<a name="ql-functions.string"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [CHARACTER\$1LENGTH](ql-functions.character_length.md)
+ [LOWER](ql-functions.lower.md)
+ [SUBSTRING](ql-functions.substring.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)

## Funciones de formato de tipo de datos
<a name="ql-functions.formatting"></a>
+ [CAST](ql-functions.cast.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)

# Función AVG en Amazon QLDB
<a name="ql-functions.avg"></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, utilice la función `AVG` para devolver el promedio (media aritmética) de los valores de la expresión de entrada. Esta función funciona con valores numéricos e ignora los valores nulos o faltantes.

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

```
AVG ( expression )
```

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

*expression*  
El nombre de campo o la expresión de un tipo de datos numérico sobre el que opera la función.

## Tipos de datos
<a name="ql-functions.avg.data-types"></a>

Tipos de argumentos admitidos:
+ `int`
+ `decimal`
+ `float`

Tipo de devolución: `decimal`

## Ejemplos
<a name="ql-functions.avg.examples"></a>

```
SELECT AVG(r.PendingPenaltyTicketAmount) FROM VehicleRegistration r  -- 147.19
SELECT AVG(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>         -- 2.
```

## Funciones relacionadas
<a name="ql-functions.avg.related"></a>
+ [COUNT](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)

# Función CAST en Amazon QLDB
<a name="ql-functions.cast"></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 `CAST` para evaluar una expresión determinada en un valor y convertir el valor en un tipo de datos de destino específico. Si la conversión no puede realizarse, la función devolverá un error.

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

```
CAST ( expression AS type )
```

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

*expression*  
El nombre del campo o expresión que se evalúa para obtener el valor que la función convierte. La conversión de valores nulos devuelve valores nulos. Este parámetro puede ser cualquiera de los [Tipos de datos](ql-reference.data-types.md) compatibles.

*type*  
El nombre del tipo de datos de destino para la conversión. Este parámetro puede ser uno de los [Tipos de datos](ql-reference.data-types.md) compatibles.

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

El tipo de datos que especifica el argumento. *type*

## Ejemplos
<a name="ql-functions.cast.examples"></a>

Los siguientes ejemplos muestran la propagación de tipos desconocidos (`NULL` o `MISSING`).

```
CAST(null    AS null)    -- null 
CAST(missing AS null)    -- null 
CAST(missing AS missing) -- missing
CAST(null    AS missing) -- missing
CAST(null    AS boolean) -- null (null AS any data type name results in null)
CAST(missing AS boolean) -- missing (missing AS any data type name results in missing)
```

Los valores que no sean de un tipo desconocido no se pueden convertir en `NULL` o`MISSING`.

```
CAST(true AS null)    -- error 
CAST(true AS missing) -- error
CAST(1    AS null)    -- error
CAST(1    AS missing) -- error
```

En los siguientes ejemplos se muestra la conversión `AS boolean`.

```
CAST(true      AS boolean) -- true no-op
CAST(0         AS boolean) -- false
CAST(1         AS boolean) -- true
CAST(`1e0`     AS boolean) -- true (float)
CAST(`1d0`     AS boolean) -- true (decimal)
CAST('a'       AS boolean) -- false
CAST('true'    AS boolean) -- true (SqlName string 'true')
CAST(`'true'`  AS boolean) -- true (Ion symbol `'true'`)
CAST(`'false'` AS boolean) -- false (Ion symbol `'false'`)
```

En los siguientes ejemplos se muestra la conversión `AS integer`.

```
CAST(true   AS integer) -- 1
CAST(false  AS integer) -- 0
CAST(1      AS integer) -- 1
CAST(`1d0`  AS integer) -- 1
CAST(`1d3`  AS integer) -- 1000
CAST(1.00   AS integer) -- 1
CAST(1.45   AS integer) -- 1
CAST(1.75   AS integer) -- 1
CAST('12'   AS integer) -- 12
CAST('aa'   AS integer) -- error
CAST(`'22'` AS integer) -- 22
CAST(`'x'`  AS integer) -- error
```

En los siguientes ejemplos se muestra la conversión `AS float`.

```
CAST(true   AS float) -- 1e0
CAST(false  AS float) -- 0e0
CAST(1      AS float) -- 1e0
CAST(`1d0`  AS float) -- 1e0
CAST(`1d3`  AS float) -- 1000e0
CAST(1.00   AS float) -- 1e0
CAST('12'   AS float) -- 12e0
CAST('aa'   AS float) -- error
CAST(`'22'` AS float) -- 22e0
CAST(`'x'`  AS float) -- error
```

En los siguientes ejemplos se muestra la conversión `AS decimal`.

```
CAST(true   AS decimal) -- 1.
CAST(false  AS decimal) -- 0.
CAST(1      AS decimal) -- 1.
CAST(`1d0`  AS decimal) -- 1. (REPL printer serialized to 1.)
CAST(`1d3`  AS decimal) -- 1d3
CAST(1.00   AS decimal) -- 1.00
CAST('12'   AS decimal) -- 12.
CAST('aa'   AS decimal) -- error
CAST(`'22'` AS decimal) -- 22.
CAST(`'x'`  AS decimal) -- error
```

En los siguientes ejemplos se muestra la conversión `AS timestamp`.

```
CAST(`2001T`                      AS timestamp) -- 2001T
CAST('2001-01-01T'                AS timestamp) -- 2001-01-01T
CAST(`'2010-01-01T00:00:00.000Z'` AS timestamp) -- 2010-01-01T00:00:00.000Z
CAST(true                         AS timestamp) -- error
CAST(2001                         AS timestamp) -- error
```

En los siguientes ejemplos se muestra la conversión `AS symbol`.

```
CAST(`'xx'`                     AS symbol) -- xx (`'xx'` is an Ion symbol)
CAST('xx'                       AS symbol) -- xx ('xx' is a string)
CAST(42                         AS symbol) -- '42'
CAST(`1e0`                      AS symbol) -- '1.0'
CAST(`1d0`                      AS symbol) -- '1'
CAST(true                       AS symbol) -- 'true'
CAST(false                      AS symbol) -- 'false'
CAST(`2001T`                    AS symbol) -- '2001T'
CAST(`2001-01-01T00:00:00.000Z` AS symbol) -- '2001-01-01T00:00:00.000Z'
```

En los siguientes ejemplos se muestra la conversión `AS string`.

```
CAST(`'xx'`                     AS string) -- "xx" (`'xx'` is an Ion symbol)
CAST('xx'                       AS string) -- "xx" ('xx' is a string)
CAST(42                         AS string) -- "42"
CAST(`1e0`                      AS string) -- "1.0"
CAST(`1d0`                      AS string) -- "1"
CAST(true                       AS string) -- "true"
CAST(false                      AS string) -- "false"
CAST(`2001T`                    AS string) -- "2001T"
CAST(`2001-01-01T00:00:00.000Z` AS string) -- "2001-01-01T00:00:00.000Z"
```

En los siguientes ejemplos se muestra la conversión `AS struct`.

```
CAST(`{ a: 1 }` AS struct) -- {a:1}
CAST(true       AS struct) -- err
```

En los siguientes ejemplos se muestra la conversión `AS list`.

```
CAST(`[1, 2, 3]`        AS list) -- [1,2,3]
CAST(<<'a', { 'b':2 }>> AS list) -- ["a",{'b':2}]
CAST({ 'b':2 }          AS list) -- error
```

Los siguientes ejemplos son instrucciones ejecutables que incluyen algunos de los ejemplos anteriores.

```
SELECT CAST(true AS integer) FROM << 0 >>            -- 1
SELECT CAST('2001-01-01T' AS timestamp) FROM << 0 >> -- 2001-01-01T
SELECT CAST('xx' AS symbol) FROM << 0 >>             -- xx
SELECT CAST(42 AS string) FROM << 0 >>               -- "42"
```

## Funciones relacionadas
<a name="ql-functions.cast.related"></a>
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)

# Función CHAR\$1LENGTH en Amazon QLDB
<a name="ql-functions.char_length"></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 `CHAR_LENGTH` para devolver el número de caracteres de la cadena especificada, donde *character* se define como un único punto de código Unicode.

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

```
CHAR_LENGTH ( string )
```

`CHAR_LENGTH` es sinónimo de [Función CHARACTER\$1LENGTH en Amazon QLDB](ql-functions.character_length.md).

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

*string*  
El nombre de campo o la expresión del tipo de datos `string` que evalúa la función.

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

`int`

## Ejemplos
<a name="ql-functions.char_length.examples"></a>

```
SELECT CHAR_LENGTH('') FROM << 0 >>        -- 0
SELECT CHAR_LENGTH('abcdefg') FROM << 0 >> -- 7
SELECT CHAR_LENGTH('eࠫ') FROM << 0 >>      -- 2 (because 'eࠫ' is two code points: the letter 'e' and combining character U+032B)
```

## Funciones relacionadas
<a name="ql-functions.char_length.related"></a>
+ [LOWER](ql-functions.lower.md)
+ [SUBSTRING](ql-functions.substring.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)

# Función CHARACTER\$1LENGTH en Amazon QLDB
<a name="ql-functions.character_length"></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.

Sinónimo de la función `CHAR_LENGTH`.

Consulte [Función CHAR\$1LENGTH en Amazon QLDB](ql-functions.char_length.md).

# Función COALESCE en Amazon QLDB
<a name="ql-functions.coalesce"></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, dada una lista de uno o más argumentos, use la función `COALESCE` para evaluar los argumentos en orden de izquierda a derecha y devolver el primer valor que no sea de tipo desconocido (`NULL` o `MISSING`). Si todos los tipos de argumentos son desconocidos, el resultado es `NULL`.

La función `COALESCE` no propaga `NULL` ni `MISSING`.

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

```
COALESCE ( expression [, expression, ... ] )
```

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

*expression*  
La lista de uno o varios nombres de campo o expresiones que evalúa la función. Cada argumento puede ser cualquiera de los [Tipos de datos](ql-reference.data-types.md) compatibles.

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

Cualquier tipo de datos compatible. El tipo de retorno es o bien `NULL` o bien el tipo de la primera expresión que se evalúa como un valor no nulo y no faltante.

## Ejemplos
<a name="ql-functions.coalesce.examples"></a>

```
SELECT COALESCE(1, null) FROM << 0 >>         -- 1
SELECT COALESCE(null, null, 1) FROM << 0 >>   -- 1
SELECT COALESCE(null, 'string') FROM << 0 >>  -- "string"
```

## Funciones relacionadas
<a name="ql-functions.coalesce.related"></a>
+ [EXISTS](ql-functions.exists.md)
+ [NULLIF](ql-functions.nullif.md)

# Función COUNT en Amazon QLDB
<a name="ql-functions.count"></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 `COUNT` para devolver el número de documentos definidos por la expresión dada. Esta función tiene dos variaciones:
+ `COUNT(*)`: cuenta todos los documentos de la tabla de destino, incluyan o no valores nulos o faltantes.
+ `COUNT(expression)`: calcula el número de documentos con valores no nulos en un campo o expresión existente específico.

**aviso**  
La función `COUNT` no está optimizada, por lo que no recomendamos usarla sin una búsqueda indexada. Cuando ejecuta una consulta en QLDB sin una búsqueda indexada, se invoca un escaneo completo de la tabla. Esto puede provocar problemas de rendimiento en tablas grandes, como conflictos de concurrencia y tiempos de espera de las transacciones.  
Para evitar el escaneado de tablas, debe ejecutar las instrucciones con una cláusula de predicado `WHERE` usando un operador de *igualdad* (`=` o `IN`) en un campo indexado o en un ID de documento. Para obtener más información, consulte [Optimización del rendimiento de las consultas](working.optimize.md).

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

```
COUNT ( * | expression )
```

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

*expression*  
El nombre de campo o la expresión sobre la que opera la función. Este parámetro puede ser cualquiera de los [Tipos de datos](ql-reference.data-types.md) compatibles.

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

`int`

## Ejemplos
<a name="ql-functions.count.examples"></a>

```
SELECT COUNT(*) FROM VehicleRegistration r WHERE r.LicensePlateNumber = 'CA762X' -- 1
SELECT COUNT(r.VIN) FROM Vehicle r WHERE r.VIN = '1N4AL11D75C109151'             -- 1
SELECT COUNT(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>                   -- 3
```

## Funciones relacionadas
<a name="ql-functions.count.related"></a>
+ [AVG](ql-functions.avg.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)

# Función DATE\$1ADD en Amazon QLDB
<a name="ql-functions.date_add"></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 `DATE_ADD` para incrementar un valor de marca de tiempo determinado en un intervalo específico.

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

```
DATE_ADD( datetimepart, interval, timestamp )
```

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

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

*interval*  
El número entero que especifica el intervalo que se va a añadir al intervalo dado. *timestamp* Un número entero negativo resta al intervalo.

*timestamp*  
El nombre de campo o la expresión del tipo de datos `timestamp` que incrementa la función.  
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.date_add.return-type"></a>

`timestamp`

## Ejemplos
<a name="ql-functions.date_add.examples"></a>

```
DATE_ADD(year, 5, `2010-01-01T`)                -- 2015-01-01T
DATE_ADD(month, 1, `2010T`)                     -- 2010-02T (result adds precision as necessary)
DATE_ADD(month, 13, `2010T`)                    -- 2011-02T (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_ADD(day, -1, `2017-01-10T`)                -- 2017-01-09T
DATE_ADD(hour, 1, `2017T`)                      -- 2017-01-01T01:00Z
DATE_ADD(hour, 1, `2017-01-02T03:04Z`)          -- 2017-01-02T04:04Z
DATE_ADD(minute, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:05:05.006Z
DATE_ADD(second, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:04:06.006Z

-- Runnable statements
SELECT DATE_ADD(year, 5, `2010-01-01T`) FROM << 0 >> -- 2015-01-01T
SELECT DATE_ADD(day, -1, `2017-01-10T`) FROM << 0 >> -- 2017-01-09T
```

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

# Función DATE\$1DIFF en Amazon QLDB
<a name="ql-functions.date_diff"></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 `DATE_DIFF` para devolver la diferencia entre las partes de fecha especificadas de dos marcas de tiempo determinadas.

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

```
DATE_DIFF( datetimepart, timestamp1, timestamp2 )
```

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

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

*timestamp1*, *timestamp2*  
Los dos nombres de cambo o expresiones del tipo de datos `timestamp` que compara la función. Si *timestamp2* es posterior, el resultado es positivo*timestamp1*. Si *timestamp2* es anterior*timestamp1*, el resultado es negativo.  
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.date_diff.return-type"></a>

`int`

## Ejemplos
<a name="ql-functions.date_diff.examples"></a>

```
DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010-12T`, `2011-01T`)                  -- 0 (must be at least 12 months apart to evaluate as a 1 year difference)
DATE_DIFF(month, `2010T`, `2010-05T`)                    -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(month, `2010-12-31T`, `2011-01-01T`)           -- 0 (must be at least a full month apart to evaluate as a 1 month difference)
DATE_DIFF(day, `2010-01-01T23:00Z`, `2010-01-02T01:00Z`) -- 0 (must be at least 24 hours apart to evaluate as a 1 day difference)

-- Runnable statements
SELECT DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`) FROM << 0 >> -- 1
SELECT DATE_DIFF(month, `2010T`, `2010-05T`) FROM << 0 >>         -- 4
```

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

# Función EXISTS en Amazon QLDB
<a name="ql-functions.exists"></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, dado un valor de PartiQL, use la función `EXISTS` para devolver `TRUE` si el valor es una colección no vacía. De lo contrario, esta función devolverá `FALSE`. Si la entrada de `EXISTS` no es un contenedor, el resultado es `FALSE`.

La función `EXISTS` no propaga `NULL` ni `MISSING`.

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

```
EXISTS ( value )
```

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

*value*  
El nombre de campo o la expresión que evalúa la función. Este parámetro puede ser cualquiera de los [Tipos de datos](ql-reference.data-types.md) compatibles.

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

`bool`

## Ejemplos
<a name="ql-functions.exists.examples"></a>

```
EXISTS(`[]`)        -- false (empty list)
EXISTS(`[1, 2, 3]`) -- true (non-empty list)
EXISTS(`[missing]`) -- true (non-empty list)
EXISTS(`{}`)        -- false (empty struct)
EXISTS(`{ a: 1 }`)  -- true (non-empty struct)
EXISTS(`()`)        -- false (empty s-expression)
EXISTS(`(+ 1 2)`)   -- true (non-empty s-expression)
EXISTS(1)           -- false
EXISTS(`2017T`)     -- false
EXISTS(null)        -- false
EXISTS(missing)     -- error

-- Runnable statements
SELECT EXISTS(`[]`) FROM << 0 >>        -- false
SELECT EXISTS(`[1, 2, 3]`) FROM << 0 >> -- true
```

## Funciones relacionadas
<a name="ql-functions.exists.related"></a>
+ [COALESCE](ql-functions.coalesce.md)
+ [NULLIF](ql-functions.nullif.md)

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

# Función LOWER en Amazon QLDB
<a name="ql-functions.lower"></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 `LOWER` para convertir todos los caracteres de una determinada cadena de mayúsculas a minúsculas.

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

```
LOWER ( string )
```

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

*string*  
El nombre de campo o la expresión del tipo de datos `string` que convierte la función.

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

`string`

## Ejemplos
<a name="ql-functions.lower.examples"></a>

```
SELECT LOWER('AbCdEfG!@#$') FROM << 0 >> -- 'abcdefg!@#$'
```

## Funciones relacionadas
<a name="ql-functions.lower.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [SUBSTRING](ql-functions.substring.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)

# Función MAX en Amazon QLDB
<a name="ql-functions.max"></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 `MAX` para devolver el valor máximo de un conjunto de valores numéricos.

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

```
MAX ( expression )
```

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

*expression*  
El nombre de campo o la expresión de un tipo de datos numérico sobre el que opera la función.

## Tipos de datos
<a name="ql-functions.max.data-types"></a>

Tipos de argumentos admitidos:
+ `int`
+ `decimal`
+ `float`

Tipos de devolución admitidos:
+ `int`
+ `decimal`
+ `float`

## Ejemplos
<a name="ql-functions.max.examples"></a>

```
SELECT MAX(r.PendingPenaltyTicketAmount) FROM VehicleRegistration r  -- 442.30
SELECT MAX(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>         -- 3
```

## Funciones relacionadas
<a name="ql-functions.max.related"></a>
+ [AVG](ql-functions.avg.md)
+ [COUNT](ql-functions.count.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)

# Función MIN en Amazon QLDB
<a name="ql-functions.min"></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 `MIN` para devolver el valor mínimo de un conjunto de valores numéricos.

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

```
MIN ( expression )
```

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

*expression*  
El nombre de campo o la expresión de un tipo de datos numérico sobre el que opera la función.

## Tipos de datos
<a name="ql-functions.min.data-types"></a>

Tipos de argumentos admitidos:
+ `int`
+ `decimal`
+ `float`

Tipos de devolución admitidos:
+ `int`
+ `decimal`
+ `float`

## Ejemplos
<a name="ql-functions.min.examples"></a>

```
SELECT MIN(r.PendingPenaltyTicketAmount) FROM VehicleRegistration r  -- 30.45
SELECT MIN(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>         -- 1
```

## Funciones relacionadas
<a name="ql-functions.min.related"></a>
+ [AVG](ql-functions.avg.md)
+ [COUNT](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)

# Función NULLIF en Amazon QLDB
<a name="ql-functions.nullif"></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, dadas dos expresiones, use la función `NULLIF` para devolver `NULL` si ambas evalúan el mismo valor. En caso contrario, la función devuelve el resultado de la evaluación de la primera expresión.

La función `NULLIF` no propaga `NULL` ni `MISSING`.

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

```
NULLIF ( expression1, expression2 )
```

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

*expression1*, *expression2*  
Los dos nombres de campo o expresiones que compara la función. Estos parámetros pueden ser cualquiera de los [Tipos de datos](ql-reference.data-types.md) admitidos.

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

Cualquier tipo de datos compatible. El tipo de devolución es `NULL` o el mismo que el tipo de la primera expresión.

## Ejemplos
<a name="ql-functions.nullif.examples"></a>

```
NULLIF(1, 1)             -- null
NULLIF(1, 2)             -- 1
NULLIF(1.0, 1)           -- null
NULLIF(1, '1')           -- 1
NULLIF([1], [1])         -- null
NULLIF(1, NULL)          -- 1
NULLIF(NULL, 1)          -- null
NULLIF(null, null)       -- null
NULLIF(missing, null)    -- null
NULLIF(missing, missing) -- null

-- Runnable statements
SELECT NULLIF(1, 1) FROM << 0 >>   -- null
SELECT NULLIF(1, '1') FROM << 0 >> -- 1
```

## Funciones relacionadas
<a name="ql-functions.nullif.related"></a>
+ [COALESCE](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)

# Función SIZE en Amazon QLDB
<a name="ql-functions.size"></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 `SIZE` para devolver el número de elementos de un determinado tipo de datos de contenedor (lista, estructura o bolsa).

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

```
SIZE ( container )
```

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

*container*  
El nombre de campo del contenedor o la expresión sobre la que opera la función.

## Tipos de datos
<a name="ql-functions.size.data-types"></a>

Tipos de argumentos admitidos:
+ list
+ estructura
+ bolsa

Tipo de devolución: `int`

Si la entrada de `SIZE` no es un contenedor, la función arroja un error.

## Ejemplos
<a name="ql-functions.size.examples"></a>

```
SIZE(`[]`)                   -- 0
SIZE(`[null]`)               -- 1
SIZE(`[1,2,3]`)              -- 3
SIZE(<<'foo', 'bar'>>)       -- 2
SIZE(`{foo: bar}`)           -- 1 (number of key-value pairs)
SIZE(`[{foo: 1}, {foo: 2}]`) -- 2
SIZE(12)                     -- error

-- Runnable statements
SELECT SIZE(`[]`) FROM << 0 >>      -- 0
SELECT SIZE(`[1,2,3]`) FROM << 0 >> -- 3
```

## Funciones relacionadas
<a name="ql-functions.size.related"></a>
+ [AVG](ql-functions.avg.md)
+ [COUNT](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SUM](ql-functions.sum.md)

# Función SUBSTRING en Amazon QLDB
<a name="ql-functions.substring"></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 `SUBSTRING` para devolver una subcadena de una cadena determinada. La subcadena comienza en el índice de inicio especificado y finaliza en el último carácter de la cadena o en la longitud especificada.

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

```
SUBSTRING ( string, start-index [, length ] )
```

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

*string*  
El nombre del campo o la expresión del tipo de datos `string` del que se va a extraer una subcadena.

*start-index*  
La posición inicial dentro de la cual se va a iniciar *string* la extracción. Este número puede ser negativo.  
El primer carácter de *string* tiene un índice de 1.

*length*  
(Opcional) El número de caracteres (puntos de código) que se van a extraer de*string*, empezando *start-index* y terminando en (*start-index*\$1*length*) - 1. Es decir, la longitud de la subcadena. Este número no puede ser negativo.  
Si no se proporciona este parámetro, la función continúa hasta el final del*string*.

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

`string`

## Ejemplos
<a name="ql-functions.substring.examples"></a>

```
SUBSTRING('123456789', 0)      -- '123456789'
SUBSTRING('123456789', 1)      -- '123456789'
SUBSTRING('123456789', 2)      -- '23456789'
SUBSTRING('123456789', -4)     -- '123456789'
SUBSTRING('123456789', 0, 999) -- '123456789'
SUBSTRING('123456789', 0, 2)   -- '1'
SUBSTRING('123456789', 1, 999) -- '123456789'
SUBSTRING('123456789', 1, 2)   -- '12'
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', -4, 0)          -- ''
SUBSTRING('1234', 10, 10)      -- ''

-- Runnable statements
SELECT SUBSTRING('123456789', 1) FROM << 0 >>    -- "123456789"
SELECT SUBSTRING('123456789', 1, 2) FROM << 0 >> -- "12"
```

## Funciones relacionadas
<a name="ql-functions.substring.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [LOWER](ql-functions.lower.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)

# Función SUM en Amazon QLDB
<a name="ql-functions.sum"></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 `SUM` para devolver la suma de los valores del campo de entrada o de la expresión. Esta función funciona con valores numéricos e ignora los valores nulos o faltantes.

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

```
SUM ( expression )
```

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

*expression*  
El nombre de campo o la expresión de un tipo de datos numérico sobre el que opera la función.

## Tipos de datos
<a name="ql-functions.sum.data-types"></a>

Tipos de argumentos admitidos:
+ `int`
+ `decimal`
+ `float`

Tipos de devolución admitidos:
+ `int`: para argumentos de números enteros
+ `decimal`: para argumentos decimales o de punto flotante

## Ejemplos
<a name="ql-functions.sum.examples"></a>

```
SELECT SUM(r.PendingPenaltyTicketAmount) FROM VehicleRegistration r  -- 735.95
SELECT SUM(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>         -- 6
```

## Funciones relacionadas
<a name="ql-functions.sum.related"></a>
+ [AVG](ql-functions.avg.md)
+ [COUNT](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)

# Función TO\$1STRING en Amazon QLDB
<a name="ql-functions.to_string"></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 `TO_STRING` para devolver una representación en cadena de una marca de tiempo determinada en el patrón de formato especificado.

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

```
TO_STRING ( timestamp, 'format' )
```

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

*timestamp*  
El nombre de campo o la expresión de un tipo de datos `timestamp` que convierte la función en una cadena.  
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.

*format*  
La cadena literal que especifica el patrón de formato del resultado, en términos de sus partes de fecha. Para conocer los formatos válidos, consulte [Cadenas con formato de marca de tiempo](ql-functions.timestamp-format.md).

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

`string`

## Ejemplos
<a name="ql-functions.to_string.examples"></a>

```
TO_STRING(`1969-07-20T20:18Z`, 'MMMM d, y')                     -- "July 20, 1969"
TO_STRING(`1969-07-20T20:18Z`, 'MMM d, yyyy')                   -- "Jul 20, 1969"
TO_STRING(`1969-07-20T20:18Z`, 'M-d-yy')                        -- "7-20-69"
TO_STRING(`1969-07-20T20:18Z`, 'MM-d-y')                        -- "07-20-1969"
TO_STRING(`1969-07-20T20:18Z`, 'MMMM d, y h:m a')               -- "July 20, 1969 8:18 PM"
TO_STRING(`1969-07-20T20:18Z`, 'y-MM-dd''T''H:m:ssX')           -- "1969-07-20T20:18:00Z"
TO_STRING(`1969-07-20T20:18+08:00Z`, 'y-MM-dd''T''H:m:ssX')     -- "1969-07-20T20:18:00Z"
TO_STRING(`1969-07-20T20:18+08:00`, 'y-MM-dd''T''H:m:ssXXXX')   -- "1969-07-20T20:18:00+0800"
TO_STRING(`1969-07-20T20:18+08:00`, 'y-MM-dd''T''H:m:ssXXXXX')  -- "1969-07-20T20:18:00+08:00"

-- Runnable statements
SELECT TO_STRING(`1969-07-20T20:18Z`, 'MMMM d, y') FROM << 0 >>           -- "July 20, 1969"
SELECT TO_STRING(`1969-07-20T20:18Z`, 'y-MM-dd''T''H:m:ssX') FROM << 0 >> -- "1969-07-20T20:18:00Z"
```

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

# Función TO\$1TIMESTAMP en Amazon QLDB
<a name="ql-functions.to_timestamp"></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, dada una cadena que representa una marca de tiempo, use la función `TO_TIMESTAMP` para convertir la cadena en un tipo de datos `timestamp`. Esta es la operación inversa de `TO_STRING`.

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

```
TO_TIMESTAMP ( string [, 'format' ] )
```

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

*string*  
El nombre de campo o la expresión de un tipo de datos `string` que la función convierte en una marca temporal.

*format*  
(Opcional) El literal de cadena que define el patrón de formato de la entrada*string*, en términos de sus partes de fecha. Para conocer los formatos válidos, consulte [Cadenas con formato de marca de tiempo](ql-functions.timestamp-format.md).  
Si se omite este argumento, la función asume que *string* tiene el formato de una marca de [tiempo estándar de Ion](http://amzn.github.io/ion-docs/docs/spec.html#timestamp). Esta es la manera recomendada de analizar una marca de tiempo de Ion mediante esta función.  
El rellenado con ceros es opcional cuando se emplea un símbolo de formato de un solo carácter (como `y`, `M`, `d`, `H`, `h`, `m`, `s`), pero es obligatorio para sus variantes de rellenado con ceros (como `yyyy`, `MM`, `dd`, `HH`, `hh`, `mm`, `ss`).  
Se da un tratamiento especial a los años de dos dígitos (símbolo de formato `yy`). 1900 se suma a valores superiores o iguales a 70, y 2000, a valores inferiores a 70.  
Los nombres de los meses y los indicadores AM y PM no distinguen entre mayúsculas y minúsculas.

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

`timestamp`

## Ejemplos
<a name="ql-functions.to_timestamp.examples"></a>

```
TO_TIMESTAMP('2007T')                         -- `2007T`
TO_TIMESTAMP('2007-02-23T12:14:33.079-08:00') -- `2007-02-23T12:14:33.079-08:00`
TO_TIMESTAMP('2016', 'y')                     -- `2016T`
TO_TIMESTAMP('2016', 'yyyy')                  -- `2016T`
TO_TIMESTAMP('02-2016', 'MM-yyyy')            -- `2016-02T`
TO_TIMESTAMP('Feb 2016', 'MMM yyyy')          -- `2016-02T`
TO_TIMESTAMP('February 2016', 'MMMM yyyy')     -- `2016-02T`

-- Runnable statements
SELECT TO_TIMESTAMP('2007T') FROM << 0 >>              -- 2007T
SELECT TO_TIMESTAMP('02-2016', 'MM-yyyy') FROM << 0 >> -- 2016-02T
```

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

# Función TRIM en Amazon QLDB
<a name="ql-functions.trim"></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 `TRIM` para recortar una determinada cadena eliminando los espacios en blanco iniciales y finales o un *conjunto* específico de caracteres.

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

```
TRIM ( [ LEADING | TRAILING | BOTH [ characters ] FROM ] string)
```

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

LEADING  
(Opcional) Indica que los espacios en blanco o los caracteres especificados deben eliminarse desde el principio de. *string* Si no se especifica, el comportamiento predeterminado es `BOTH`.

TRAILING  
(Opcional) Indica que los espacios en blanco o los caracteres especificados deben eliminarse del final de*string*. Si no se especifica, el comportamiento predeterminado es `BOTH`.

BOTH  
(Opcional) Indica que se deben eliminar tanto los espacios en blanco iniciales como finales o los caracteres especificados del principio y del final de*string*.

*characters*  
(Opcional) El *conjunto* de caracteres que se va a eliminar, especificado como `string`.  
Si no se proporciona este parámetro, se eliminan los espacios en blanco.

*string*  
El nombre del campo o la expresión del tipo de datos `string` que recorta la función.

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

`string`

## Ejemplos
<a name="ql-functions.trim.examples"></a>

```
TRIM('       foobar         ')               -- 'foobar'
TRIM('      \tfoobar\t         ')            -- '\tfoobar\t'
TRIM(LEADING FROM '       foobar         ')  -- 'foobar         '
TRIM(TRAILING FROM '       foobar         ') -- '       foobar'
TRIM(BOTH FROM '       foobar         ')     -- 'foobar'
TRIM(BOTH '1' FROM '11foobar11')             -- 'foobar'
TRIM(BOTH '12' FROM '1112211foobar22211122') -- 'foobar'

-- Runnable statements
SELECT TRIM('       foobar         ') FROM << 0 >>              -- "foobar"
SELECT TRIM(LEADING FROM '       foobar         ') FROM << 0 >> -- "foobar         "
```

## Funciones relacionadas
<a name="ql-functions.trim.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [LOWER](ql-functions.lower.md)
+ [SUBSTRING](ql-functions.substring.md)
+ [UPPER](ql-functions.upper.md)

# Función TXID en Amazon QLDB
<a name="ql-functions.txid"></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 `TXID` para devolver la ID de transacción única de la instrucción actual que está ejecutando. Es el valor que se asigna al campo de metadatos `txId` de un documento cuando la transacción actual se registra en el diario.

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

```
TXID()
```

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

Ninguno

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

`string`

## Ejemplos
<a name="ql-functions.txid.examples"></a>

```
SELECT TXID() FROM << 0 >>  -- "L7S9iJqcn9W2M4qOEn27ay"
SELECT TXID() FROM Person WHERE GovId = 'LEWISR261LL'  -- "BKeMb48PNyvHWJGZHkaodG"
```

# Función UPPER en Amazon QLDB
<a name="ql-functions.upper"></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 `UPPER` para convertir todos los caracteres de una determinada cadena de minúsculas a mayúsculas.

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

```
UPPER ( string )
```

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

*string*  
El nombre de campo o la expresión del tipo de datos `string` que convierte la función.

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

`string`

## Ejemplos
<a name="ql-functions.upper.examples"></a>

```
SELECT UPPER('AbCdEfG!@#$') FROM << 0 >> -- 'ABCDEFG!@#$'
```

## Funciones relacionadas
<a name="ql-functions.upper.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [LOWER](ql-functions.lower.md)
+ [SUBSTRING](ql-functions.substring.md)
+ [TRIM](ql-functions.trim.md)

# Función UTCNOW en Amazon QLDB
<a name="ql-functions.utcnow"></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 `UTCNOW` para devolver la hora actual en formato de Hora Universal Coordinada (UTC) como `timestamp`.

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

```
UTCNOW()
```

Esta función requiere que especifique una cláusula `FROM` en una consulta `SELECT`.

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

Ninguno

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

`timestamp`

## Ejemplos
<a name="ql-functions.utcnow.examples"></a>

```
SELECT UTCNOW() FROM << 0 >>  -- 2019-12-27T20:12:16.999Z
SELECT UTCNOW() FROM Person WHERE GovId = 'LEWISR261LL'  -- 2019-12-27T20:12:26.999Z

INSERT INTO Person VALUE { 'firstName': 'Jane', 'createdAt': UTCNOW() }
UPDATE Person p SET p.updatedAt = UTCNOW() WHERE p.firstName = 'John'
```

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

# Cadenas con formato de marca de tiempo
<a name="ql-functions.timestamp-format"></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 esta sección se proporciona información de referencia para las cadenas con formato de marca de tiempo.

Las cadenas con formato de marca de tiempo se aplican a las funciones `TO_STRING` y `TO_TIMESTAMP`. Estas cadenas pueden contener separadores de partes de fecha (como “`-`”, “`/`” o “`:`”) y los siguientes símbolos de formato.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/qldb/latest/developerguide/ql-functions.timestamp-format.html)