As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Funções partiQL no Amazon QLDB
<a name="ql-functions"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

A PartiQL no Amazon QLDB é compatível com as seguintes variantes integradas de funções padrão SQL.

**nota**  
As funções SQL que não estão incluídas nesta lista atualmente não têm suporte no QLDB.  
Essa referência de função é baseada na [Funções Integradas](https://github.com/partiql/partiql-lang-kotlin/blob/main/docs/wiki/documentation/Functions.md#built-in-functions) na documentação PartiQL.

**Propagação de tipo desconhecido (nulo e ausente)**

Salvo indicação em contrário, todas essas funções propagam valores de argumentos nulos e ausentes. *A propagação* de `NULL` ou `MISSING` é definida como retorno `NULL` se algum argumento de função for `NULL` ou`MISSING`. A seguir estão exemplos dessa propagação.

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

## Funções agregadas
<a name="ql-functions.aggregate"></a>
+ [AVG](ql-functions.avg.md)
+ [CONTAGEM](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)

## Funções condicionais
<a name="ql-functions.conditional"></a>
+ [AGLUTINAR](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)
+ [NULLIF](ql-functions.nullif.md)

## Perfis de data e 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)

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

## Funções de string
<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)

## Funções de formatação de tipo de dados
<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)

# Função AVG no Amazon QLDB
<a name="ql-functions.avg"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `AVG` de janela AVG para retornar a média (média aritmética) dos valores de expressão de entrada. Essa função funciona com valores numéricos e ignora valores nulos ou ausentes.

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

```
AVG ( expression )
```

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

*expression*  
O nome do campo ou expressão do tipo de dados numéricos no qual a função opera.

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

Tipos de argumento com suporte:
+ `int`
+ `decimal`
+ `float`

Tipo de retorno: `decimal`

## Exemplos
<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.
```

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

# Função CAST no Amazon QLDB
<a name="ql-functions.cast"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `CAST` para avaliar uma determinada expressão em um valor e converter o valor em um tipo de dados de destino especificado. Se a conversão não puder ser feita, a função retornará um erro.

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

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

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

*expression*  
O nome do campo ou expressão avaliada como um valor que a função converte. A conversão de valores nulos retorna nulos. Esse parâmetro pode ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

*type*  
O nome do tipo de dados de destino para conversão. Esse parâmetro pode ser um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

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

O tipo de dados especificado pelo *type* argumento.

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

Os exemplos a seguir mostram a propagação de tipos desconhecidos (`NULL` ou `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)
```

Qualquer valor que não seja de um tipo desconhecido não pode ser convertido em `NULL` ou`MISSING`.

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

Os exemplos a seguir mostram o lançamento de `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'`)
```

Os exemplos a seguir mostram o lançamento de `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
```

Os exemplos a seguir mostram o lançamento de `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
```

Os exemplos a seguir mostram o lançamento de `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
```

Os exemplos a seguir mostram o lançamento de `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
```

Os exemplos a seguir mostram o lançamento de `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'
```

Os exemplos a seguir mostram o lançamento de `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"
```

Os exemplos a seguir mostram o lançamento de `AS struct`.

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

Os exemplos a seguir mostram o lançamento de `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
```

Os exemplos a seguir são instruções executáveis que incluem alguns dos exemplos 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"
```

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

# Função CHAR\$1LENGTH no Amazon QLDB
<a name="ql-functions.char_length"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `CHAR_LENGTH` para retornar o número de caracteres na string especificada, em que o *caractere* é definido como um único ponto de código Unicode.

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

```
CHAR_LENGTH ( string )
```

`CHAR_LENGTH` é sinônimo de [Função CHARACTER\$1LENGTH no Amazon QLDB](ql-functions.character_length.md).

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

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função avalia.

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

`int`

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

## Funções 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)

# Função CHARACTER\$1LENGTH no Amazon QLDB
<a name="ql-functions.character_length"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Sinônimo da função `CHAR_LENGTH`.

Consulte [Função CHAR\$1LENGTH no Amazon QLDB](ql-functions.char_length.md).

# Função AGLUTINAR no Amazon QLDB
<a name="ql-functions.coalesce"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, com uma lista de um ou mais argumentos, use `COALESCE` a função para avaliar os argumentos na ordem da esquerda para a direita e retornar o primeiro valor que não seja de um tipo desconhecido (`NULL` ou `MISSING`). Se todos os tipos de argumentos forem desconhecidos, o resultado será `NULL`.

A função `COALESCE` não propaga `NULL` e `MISSING`.

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

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

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

*expression*  
A lista de um ou mais nomes de campo ou expressões que a função avalia. Cada argumento pode ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

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

Qualquer tipo de dados com suporte. O tipo de retorno é `NULL` ou igual ao tipo da primeira expressão que é avaliada como um valor não nulo e não ausente.

## Exemplos
<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"
```

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

# Função COUNT no Amazon QLDB
<a name="ql-functions.count"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `COUNT` para retornar o número de documentos que são definidos pela expressão dada. A função tem duas variações:
+ `COUNT(*)`: conta todos os documentos na tabela de destino, independentemente de incluírem ou não valores nulos ou ausentes.
+ `COUNT(expression)`: calcula o número de documentos com valores não nulos em um campo ou expressão específica existente.

**Atenção**  
A função `COUNT` não está otimizada, portanto, não recomendamos usá-la sem uma pesquisa indexada. Quando você executa uma consulta no QLDB sem uma pesquisa indexada, ela invoca uma verificação completa da tabela. Isso pode causar problemas de desempenho em tabelas grandes, incluindo conflitos de simultaneidade e tempos limite de transação.  
Para evitar verificações de tabelas, você deve executar instruções com uma cláusula de predicado `WHERE` usando um operador de *igualdade* (`=` ou `IN`) em um campo indexado ou em um ID de documento. Para obter mais informações, consulte [Otimizar a performance da consulta](working.optimize.md).

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

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

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

*expression*  
O nome do campo ou expressão na qual a função opera. Esse parâmetro pode ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

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

`int`

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

## Funções 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)

# Função DATE\$1ADD no Amazon QLDB
<a name="ql-functions.date_add"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `DATE_ADD` para incrementar um determinado valor de carimbo de data/hora em um intervalo especificado.

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

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

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

*datetimepart*  
A parte da data ou hora na qual a função opera. Esse parâmetro pode ser:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*interval*  
O número inteiro que especifica o intervalo a ser adicionado ao dado. *timestamp* Um número inteiro negativo subtrai o intervalo.

*timestamp*  
O nome do campo ou a expressão do tipo de dados `timestamp` que a função incrementa.  
Um valor literal de timestamp de Ion pode ser indicado com backticks (``...``). Para obter detalhes do formato e exemplos de valores de carimbo de data/hora, consulte [Timestamps](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) no documento de especificação do Amazon Ion.

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

`timestamp`

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

## Funções 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)

# Função DATE\$1DIFF no Amazon QLDB
<a name="ql-functions.date_diff"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `DATE_DIFF` para retornar a diferença entre as partes de data especificadas de dois timestamps determinados.

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

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

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

*datetimepart*  
A parte da data ou hora na qual a função opera. Esse parâmetro pode ser:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*timestamp1*, *timestamp2*  
O nome do campo ou a expressão do tipo de dados `timestamp` que a função compara. Se *timestamp2* for posterior*timestamp1*, o resultado é positivo. Se *timestamp2* for anterior a*timestamp1*, o resultado será negativo.  
Um valor literal de timestamp de Ion pode ser indicado com backticks (``...``). Para obter detalhes do formato e exemplos de valores de carimbo de data/hora, consulte [Timestamps](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) no documento de especificação do Amazon Ion.

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

`int`

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

## Funções 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)

# Função EXISTS no Amazon QLDB
<a name="ql-functions.exists"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, dado um valor partiQL, use a função `EXISTS` para retornar `TRUE` se o valor for uma coleção não vazia. Caso contrário, essa função retornará `FALSE`. Se a entrada para `EXISTS` não for um contêiner, o resultado será `FALSE`.

A função `EXISTS` não propaga `NULL` e `MISSING`.

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

```
EXISTS ( value )
```

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

*value*  
O nome do campo ou a expressão que a função avalia. Esse parâmetro pode ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

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

`bool`

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

## Funções relacionadas
<a name="ql-functions.exists.related"></a>
+ [AGLUTINAR](ql-functions.coalesce.md)
+ [NULLIF](ql-functions.nullif.md)

# Função EXTRACT no Amazon QLDB
<a name="ql-functions.extract"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `EXTRACT` para retornar o valor inteiro de uma parte de data ou hora especificada de um determinado timestamp.

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

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

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

*datetimepart*  
A parte da data ou hora na qual a função extrai. Esse parâmetro pode ser:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`
+ `timezone_hour`
+ `timezone_minute`

*timestamp*  
O nome do campo ou a expressão do tipo de dados `timestamp` que a função extrai. Se esse parâmetro for de um tipo desconhecido (`NULL`ou`MISSING`), a função retornará `NULL`.  
Um valor literal de timestamp de Ion pode ser indicado com backticks (``...``). Para obter detalhes do formato e exemplos de valores de carimbo de data/hora, consulte [Timestamps](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) no documento de especificação do Amazon Ion.

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

`int`

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

## Funções 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)

# Função LOWER no Amazon QLDB
<a name="ql-functions.lower"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `LOWER` para converter todos os caracteres maiúsculos em minúsculos em uma determinada string.

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

```
LOWER ( string )
```

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

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função converte.

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

`string`

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

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

## Funções 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)

# Função MAX no Amazon QLDB
<a name="ql-functions.max"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `MAX` para retornar o valor máximo em um conjunto de valores numéricos.

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

```
MAX ( expression )
```

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

*expression*  
O nome do campo ou expressão do tipo de dados numéricos no qual a função opera.

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

Tipos de argumento com suporte:
+ `int`
+ `decimal`
+ `float`

Tipos de devoluções compatíveis:
+ `int`
+ `decimal`
+ `float`

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

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

# Função MIN no Amazon QLDB
<a name="ql-functions.min"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `MIN` para retornar o valor mínimo em um conjunto de valores numéricos.

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

```
MIN ( expression )
```

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

*expression*  
O nome do campo ou expressão do tipo de dados numéricos no qual a função opera.

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

Tipos de argumento com suporte:
+ `int`
+ `decimal`
+ `float`

Tipos de devoluções compatíveis:
+ `int`
+ `decimal`
+ `float`

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

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

# Função NULLIF no Amazon QLDB
<a name="ql-functions.nullif"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, dadas as duas expressões, use a função `NULLIF` para retornar `NULL` se as duas forem avaliadas para o mesmo valor. Caso contrário, essa função retornará o resultado da avaliação da primeira expressão.

A função `NULLIF` não propaga `NULL` e `MISSING`.

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

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

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

*expression1*, *expression2*  
O dois nomes do campo ou a expressão do tipo de dados que a função compara. Esses parâmetros podem ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

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

Qualquer tipo de dados com suporte. O tipo de retorno é `NULL` ou igual ao tipo da primeira expressão.

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

## Funções relacionadas
<a name="ql-functions.nullif.related"></a>
+ [AGLUTINAR](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)

# Função SIZE no Amazon QLDB
<a name="ql-functions.size"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `SIZE` para retornar o número de elementos em um determinado tipo de dados de contêiner (lista, estrutura ou bolsa).

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

```
SIZE ( container )
```

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

*container*  
O nome do campo ou expressão do contêiner no qual a função opera.

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

Tipos de argumento com suporte:
+ list
+ estrutura
+ bolsa

Tipo de retorno: `int`

Se a entrada para `SIZE` não for um contêiner, a função gerará um erro.

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

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

# Função SUBSTRING no Amazon QLDB
<a name="ql-functions.substring"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `SUBSTRING` para retornar uma substring de uma determinada string. A substring começa no índice de início especificado e termina no último caractere da string ou no comprimento especificado.

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

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

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

*string*  
O nome do campo ou a expressão do tipo de dados `string` do qual extrair uma substring.

*start-index*  
A posição inicial dentro *string* da qual iniciar a extração. Esse número pode ser negativo.  
O primeiro caractere de *string* tem um índice de 1.

*length*  
(Opcional) O número de caracteres (pontos de código) a serem extraídos do*string*, começando em *start-index* e terminando em (*start-index*\$1*length*) - 1. Em outras palavras, o comprimento da substring. Esse número não pode ser negativo.  
Se esse parâmetro não for fornecido, a função prosseguirá até o final do*string*.

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

`string`

## Exemplos
<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"
```

## Funções 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)

# Função SUM no Amazon QLDB
<a name="ql-functions.sum"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `SUM` de janela AVG para retornar a soma do campo de entrada ou dos valores de expressão. Essa função funciona com valores numéricos e ignora valores nulos ou ausentes.

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

```
SUM ( expression )
```

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

*expression*  
O nome do campo ou expressão do tipo de dados numéricos no qual a função opera.

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

Tipos de argumento com suporte:
+ `int`
+ `decimal`
+ `float`

Tipos de devoluções compatíveis:
+ `int`: para argumentos inteiros
+ `decimal`: para argumentos decimais ou de ponto flutuante

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

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

# Função TO\$1STRING no Amazon QLDB
<a name="ql-functions.to_string"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `TO_STRING` para retornar uma representação de string de um determinado timestamp no padrão de formato especificado.

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

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

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

*timestamp*  
O nome do campo ou a expressão do tipo de dados `timestamp` que a função converte em uma string.  
Um valor literal de timestamp de Ion pode ser indicado com backticks (``...``). Para obter detalhes do formato e exemplos de valores de carimbo de data/hora, consulte [Timestamps](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) no documento de especificação do Amazon Ion.

*format*  
A string literal que especifica o padrão de formato do resultado, em termos de suas partes de data. Para obter os formatos válidos, consulte [Strings de formato da data e hora](ql-functions.timestamp-format.md).

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

`string`

## Exemplos
<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"
```

## Funções 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)

# Função TO\$1TIMESTAMP no Amazon QLDB
<a name="ql-functions.to_timestamp"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, dada uma string que representa um timestamp, use a função `TO_TIMESTAMP` para converter a string em um tipo de dados `timestamp`. Esta é a operação inversa de `TO_STRING`.

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

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

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

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função converte em um timestamp.

*format*  
(Opcional) A string literal que define o padrão de formato da entrada*string*, em termos de suas partes de data. Para obter os formatos válidos, consulte [Strings de formato da data e hora](ql-functions.timestamp-format.md).  
Se esse argumento for omitido, a função assume que o *string* está no formato de um timestamp [padrão](http://amzn.github.io/ion-docs/docs/spec.html#timestamp) do Ion. Essa é a maneira recomendada de analisar um timestamp do Ion usando essa função.  
O preenchimento zero é opcional ao usar um símbolo de formato de caractere único (como `y`, `M`, `d`, `H`, `h`, `m`, `s`), mas é obrigatório para suas variantes com preenchimento zero (como `yyyy`, `MM`, `dd`, `HH`, `hh`, `mm`, `ss`).  
Tratamento especial é dado aos anos de dois dígitos (símbolo de formato `yy`). 1900 é adicionado a valores maiores que ou iguais a 70 e 2000 é adicionado a valores menores que 70.  
Os nomes dos meses e os indicadores AM ou PM não diferenciam maiúsculas de minúsculas.

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

`timestamp`

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

## Funções 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)

# Função TRIM no Amazon QLDB
<a name="ql-functions.trim"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

*No Amazon QLDB, use a função `TRIM` para cortar uma determinada string removendo os espaços em branco em trilha à esquerda e à direita ou um conjunto* específico de caracteres.

## Sintaxe
<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 os espaços em branco ou os caracteres especificados devem ser removidos do início de*string*. Se não especificado, o comportamento padrão será `BOTH`.

TRAILING  
(Opcional) Indica que os espaços em branco ou os caracteres especificados devem ser removidos do final de*string*. Se não especificado, o comportamento padrão será `BOTH`.

BOTH  
(Opcional) Indica que os espaços em branco à esquerda e à direita ou os caracteres especificados devem ser removidos do início e do final de*string*.

*characters*  
(Opcional) O *conjunto* de caracteres a serem removidos, especificado como um `string`.  
Se esse parâmetro não for fornecido, os espaços em branco serão removidos.

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função corta.

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

`string`

## Exemplos
<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         "
```

## Funções 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)

# Função TXID no Amazon QLDB
<a name="ql-functions.txid"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `TXID` para retornar o ID da transação exclusivo da instrução atual que você está executando. Esse é o valor atribuído ao campo de metadados `txId` de um documento quando a transação atual é confirmada no diário.

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

```
TXID()
```

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

Nenhum

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

`string`

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

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

# Função UPPER no Amazon QLDB
<a name="ql-functions.upper"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `UPPER` para converter todos os caracteres minúsculos para maiúsculos em uma determinada string.

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

```
UPPER ( string )
```

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

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função converte.

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

`string`

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

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

## Funções 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)

# Função UTCNOW no Amazon QLDB
<a name="ql-functions.utcnow"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `UTCNOW` para retornar a hora atual no Horário Universal Coordenado (UTC) como uma `timestamp`

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

```
UTCNOW()
```

Essa função exige que você especifique uma cláusula `FROM` em uma consulta `SELECT`.

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

Nenhum

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

`timestamp`

## Exemplos
<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'
```

## Funções 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)

# Strings de formato da data e hora
<a name="ql-functions.timestamp-format"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Esta seção fornece informações de referência para strings de caracteres de formato da data e hora.

As strings de formato da data e hora se aplicam às funções `TO_STRING` e `TO_TIMESTAMP`. Essas strings de caracteres podem conter separadores de partes de data (como '`-`', '`/`' ou '`:`') e os seguintes símbolos de formato.

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