Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Funzioni PartiQL in Amazon QLDB
<a name="ql-functions"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

PartiQL in Amazon QLDB supporta le seguenti varianti integrate delle funzioni standard SQL.

**Nota**  
Tutte le funzioni SQL che non sono incluse in questo elenco non sono attualmente supportate in QLDB.  
Questo riferimento alla funzione si basa sulla documentazione PartiQL [Built-in](https://github.com/partiql/partiql-lang-kotlin/blob/main/docs/wiki/documentation/Functions.md#built-in-functions) Functions.

**Propagazione di tipo sconosciuto (nulla e mancante)**

Salvo diversa indicazione, tutte queste funzioni propagano valori di argomento nulli e mancanti. *La propagazione* di `NULL` o `MISSING` è definita come restituzione `NULL` se un argomento della funzione è o. `NULL` `MISSING` Di seguito sono riportati alcuni esempi di questa propagazione.

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

## Funzioni di aggregazione
<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)

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

## Funzioni di data e ora
<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)

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

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

## Funzioni di formattazione del tipo di dati
<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)

# Funzione AVG in Amazon QLDB
<a name="ql-functions.avg"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `AVG` la funzione per restituire la media (media aritmetica) dei valori delle espressioni di input. Questa funzione funziona con valori numerici e ignora i valori nulli o mancanti.

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

```
AVG ( expression )
```

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

*expression*  
Il nome di campo o l'espressione di un tipo di dati numerico su cui opera la funzione.

## Tipi di dati
<a name="ql-functions.avg.data-types"></a>

Tipi di argomenti supportati:
+ `int`
+ `decimal`
+ `float`

Tipo di restituzione: `decimal`

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

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

# Funzione CAST in Amazon QLDB
<a name="ql-functions.cast"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `CAST` la funzione per valutare una determinata espressione in un valore e convertire il valore in un tipo di dati di destinazione specificato. Se la conversione non può essere effettuata, la funzione restituisce un errore.

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

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

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

*expression*  
Il nome di campo o l'espressione che restituisce un valore convertito dalla funzione. La conversione di valori null restituisce null. Questo parametro può essere uno qualsiasi dei supportati. [Tipi di dati](ql-reference.data-types.md)

*type*  
Il nome del tipo di dati di destinazione per la conversione. Questo parametro può essere uno dei supportati[Tipi di dati](ql-reference.data-types.md).

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

Il tipo di dati specificato dall'*type*argomento.

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

Gli esempi seguenti mostrano la propagazione di tipi sconosciuti (`NULL`or`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)
```

Qualsiasi valore che non sia di tipo sconosciuto non può essere convertito in `NULL` o`MISSING`.

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

Gli esempi seguenti mostrano il casting`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'`)
```

Gli esempi seguenti mostrano il casting`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
```

Gli esempi seguenti mostrano il casting`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
```

Gli esempi seguenti mostrano il casting`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
```

Gli esempi seguenti mostrano il casting`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
```

Gli esempi seguenti mostrano il casting`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'
```

Gli esempi seguenti mostrano il casting`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"
```

Gli esempi seguenti mostrano il casting`AS struct`.

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

Gli esempi seguenti mostrano il casting`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
```

Gli esempi seguenti sono istruzioni eseguibili che includono alcuni degli esempi precedenti.

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

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

# Funzione CHAR\$1LENGTH in Amazon QLDB
<a name="ql-functions.char_length"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `CHAR_LENGTH` la funzione per restituire il numero di caratteri nella stringa specificata, *dove* il carattere è definito come un singolo punto di codice Unicode.

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

```
CHAR_LENGTH ( string )
```

`CHAR_LENGTH`è sinonimo di. [Funzione CHARACTER\$1LENGTH in Amazon QLDB](ql-functions.character_length.md)

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

*string*  
Il nome di campo o l'espressione del tipo di `string` dati valutato dalla funzione.

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

`int`

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

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

# Funzione CHARACTER\$1LENGTH in Amazon QLDB
<a name="ql-functions.character_length"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Sinonimo della funzione `CHAR_LENGTH`.

Per informazioni, consulta [Funzione CHAR\$1LENGTH in Amazon QLDB](ql-functions.char_length.md).

# Funzione COALESCE in Amazon QLDB
<a name="ql-functions.coalesce"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, dato un elenco di uno o più argomenti, usa `COALESCE` la funzione per valutare gli argomenti in ordine da sinistra a destra e restituire il primo valore che non sia un tipo `NULL` sconosciuto (o). `MISSING` Se tutti i tipi di argomento sono sconosciuti, il risultato è. `NULL`

La `COALESCE` funzione non si propaga `NULL` e`MISSING`.

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

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

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

*expression*  
L'elenco di uno o più nomi di campo o espressioni valutati dalla funzione. Ogni argomento può essere uno dei supportati[Tipi di dati](ql-reference.data-types.md).

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

Qualsiasi tipo di dati supportato. Il tipo restituito è `NULL` o lo stesso del tipo della prima espressione che restituisce un valore non nullo e non mancante.

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

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

# Funzione COUNT in Amazon QLDB
<a name="ql-functions.count"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `COUNT` la funzione per restituire il numero di documenti definiti dall'espressione specificata. Questa funzione ha due varianti:
+ `COUNT(*)`— Conta tutti i documenti nella tabella di destinazione indipendentemente dal fatto che includano o meno valori nulli o mancanti.
+ `COUNT(expression)`— Calcola il numero di documenti con valori non nulli in un campo o un'espressione specifica ed esistente.

**avvertimento**  
La `COUNT` funzione non è ottimizzata, quindi non è consigliabile utilizzarla senza una ricerca indicizzata. Quando si esegue una query in QLDB senza una ricerca indicizzata, viene richiamata una scansione completa della tabella. Ciò può causare problemi di prestazioni su tabelle di grandi dimensioni, inclusi conflitti di concorrenza e timeout delle transazioni.  
Per evitare la scansione delle tabelle, è necessario eseguire istruzioni con una clausola di `WHERE` predicato utilizzando un operatore di *uguaglianza* (`=`o`IN`) su un campo indicizzato o un ID di documento. Per ulteriori informazioni, consulta [Ottimizzazione delle prestazioni delle query](working.optimize.md).

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

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

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

*expression*  
Il nome del campo o l'espressione su cui opera la funzione. Questo parametro può essere uno qualsiasi dei supportati[Tipi di dati](ql-reference.data-types.md).

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

`int`

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

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

# Funzione DATE\$1ADD in Amazon QLDB
<a name="ql-functions.date_add"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `DATE_ADD` la funzione per incrementare un determinato valore di timestamp in base a un intervallo specificato.

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

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

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

*datetimepart*  
La parte relativa alla data o all'ora in cui opera la funzione. Questo parametro può essere uno dei seguenti:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*interval*  
Il numero intero che specifica l'intervallo da aggiungere al dato. *timestamp* Un intero negativo sottrae l'intervallo.

*timestamp*  
Il nome di campo o l'espressione del tipo di dati `timestamp` che la funzione incrementa.  
Un valore letterale del timestamp di Ion può essere indicato con backticks (). ``...`` Per dettagli sulla formattazione ed esempi di valori di timestamp, consulta [Timestamp](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) nel documento delle specifiche di Amazon Ion.

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

`timestamp`

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

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

# Funzione DATE\$1DIFF in Amazon QLDB
<a name="ql-functions.date_diff"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `DATE_DIFF` la funzione per restituire la differenza tra le parti di data specificate di due determinati timestamp.

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

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

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

*datetimepart*  
La parte relativa alla data o all'ora in cui opera la funzione. Questo parametro può essere uno dei seguenti:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*timestamp1*, *timestamp2*  
I due nomi di campo o espressioni del tipo di dati `timestamp` confrontati dalla funzione. Se *timestamp2* è successivo a*timestamp1*, il risultato è positivo. Se *timestamp2* è precedente a*timestamp1*, il risultato è negativo.  
Un valore letterale del timestamp Ion può essere indicato con backticks (). ``...`` Per dettagli sulla formattazione ed esempi di valori di timestamp, consulta [Timestamp](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) nel documento delle specifiche di Amazon Ion.

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

`int`

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

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

# Funzione EXISTS in Amazon QLDB
<a name="ql-functions.exists"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, dato un valore PartiQL, usa `EXISTS` la funzione per `TRUE` restituire se il valore è una raccolta non vuota. Altrimenti, questa funzione restituisce. `FALSE` Se l'input to non `EXISTS` è un contenitore, il risultato è`FALSE`.

La `EXISTS` funzione non si propaga `NULL` e`MISSING`.

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

```
EXISTS ( value )
```

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

*value*  
Il nome di campo o l'espressione valutata dalla funzione. Questo parametro può essere uno qualsiasi dei supportati[Tipi di dati](ql-reference.data-types.md).

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

`bool`

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

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

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

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `EXTRACT` la funzione per restituire il valore intero di una parte di data o ora specificata da un determinato timestamp.

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

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

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

*datetimepart*  
La parte relativa alla data o all'ora estratta dalla funzione. Questo parametro può essere uno dei seguenti:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`
+ `timezone_hour`
+ `timezone_minute`

*timestamp*  
Il nome del campo o l'espressione del tipo di dati da `timestamp` cui la funzione estrae. Se questo parametro è di tipo sconosciuto (`NULL`o`MISSING`), la funzione restituisce`NULL`.  
Un valore letterale del timestamp Ion può essere indicato con backticks (). ``...`` Per dettagli sulla formattazione ed esempi di valori di timestamp, consulta [Timestamp](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) nel documento delle specifiche di Amazon Ion.

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

`int`

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

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

# Funzione LOWER in Amazon QLDB
<a name="ql-functions.lower"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `LOWER` la funzione per convertire tutti i caratteri maiuscoli in caratteri minuscoli in una determinata stringa.

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

```
LOWER ( string )
```

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

*string*  
Il nome del campo o l'espressione del tipo di dati che la funzione converte. `string`

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

`string`

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

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

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

# Funzione MAX in Amazon QLDB
<a name="ql-functions.max"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `MAX` la funzione per restituire il valore massimo in un set di valori numerici.

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

```
MAX ( expression )
```

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

*expression*  
Il nome di campo o l'espressione di un tipo di dati numerico su cui opera la funzione.

## Tipi di dati
<a name="ql-functions.max.data-types"></a>

Tipi di argomenti supportati:
+ `int`
+ `decimal`
+ `float`

Tipi di restituzione supportati:
+ `int`
+ `decimal`
+ `float`

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

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

# Funzione MIN in Amazon QLDB
<a name="ql-functions.min"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `MIN` la funzione per restituire il valore minimo in un set di valori numerici.

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

```
MIN ( expression )
```

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

*expression*  
Il nome di campo o l'espressione di un tipo di dati numerico su cui opera la funzione.

## Tipi di dati
<a name="ql-functions.min.data-types"></a>

Tipi di argomenti supportati:
+ `int`
+ `decimal`
+ `float`

Tipi di restituzione supportati:
+ `int`
+ `decimal`
+ `float`

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

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

# Funzione NULLIF in Amazon QLDB
<a name="ql-functions.nullif"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, date due espressioni, usa `NULLIF` la funzione per `NULL` restituire se le due espressioni restituiscono lo stesso valore. Altrimenti, questa funzione restituisce il risultato della valutazione della prima espressione.

La `NULLIF` funzione non si `NULL` propaga e. `MISSING`

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

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

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

*expression1*, *expression2*  
I due nomi di campo o espressioni confrontati dalla funzione. Questi parametri possono essere tutti quelli supportati[Tipi di dati](ql-reference.data-types.md).

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

Qualsiasi tipo di dati supportato. Il tipo restituito è `NULL` o lo stesso del tipo della prima espressione.

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

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

# Funzione SIZE in Amazon QLDB
<a name="ql-functions.size"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `SIZE` la funzione per restituire il numero di elementi in un determinato tipo di dati del contenitore (elenco, struttura o borsa).

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

```
SIZE ( container )
```

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

*container*  
Il nome o l'espressione del campo contenitore su cui opera la funzione.

## Tipi di dati
<a name="ql-functions.size.data-types"></a>

Tipi di argomenti supportati:
+ elenco
+ struttura
+ borsa

Tipo di reso: `int`

Se l'input to non `SIZE` è un contenitore, la funzione genera un errore.

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

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

# Funzione SUBSTRING in Amazon QLDB
<a name="ql-functions.substring"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `SUBSTRING` la funzione per restituire una sottostringa da una determinata stringa. La sottostringa inizia dall'indice iniziale specificato e termina con l'ultimo carattere della stringa o con la lunghezza specificata.

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

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

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

*string*  
Il nome di campo o l'espressione del tipo di dati `string` da cui estrarre una sottostringa.

*start-index*  
La posizione iniziale entro la *string* quale iniziare l'estrazione. Questo numero può essere negativo.  
Il primo carattere di *string* ha un indice pari a 1.

*length*  
(Facoltativo) Il numero di caratteri (punti di codice) da estrarre da*string*, che iniziano *start-index* e finiscono con (*start-index*\$1*length*) - 1. In altre parole, la lunghezza della sottostringa. Questo numero non può essere negativo.  
Se questo parametro non viene fornito, la funzione prosegue fino alla fine di. *string*

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

`string`

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

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

# Funzione SUM in Amazon QLDB
<a name="ql-functions.sum"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `SUM` la funzione per restituire la somma dei valori del campo di input o dell'espressione. Questa funzione funziona con valori numerici e ignora i valori nulli o mancanti.

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

```
SUM ( expression )
```

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

*expression*  
Il nome di campo o l'espressione di un tipo di dati numerico su cui opera la funzione.

## Tipi di dati
<a name="ql-functions.sum.data-types"></a>

Tipi di argomenti supportati:
+ `int`
+ `decimal`
+ `float`

Tipi di restituzione supportati:
+ `int`— Per argomenti interi
+ `decimal`— Per argomenti decimali o in virgola mobile

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

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

# Funzione TO\$1STRING in Amazon QLDB
<a name="ql-functions.to_string"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `TO_STRING` la funzione per restituire una rappresentazione in formato stringa di un determinato timestamp nel modello di formato specificato.

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

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

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

*timestamp*  
Il nome di campo o l'espressione del tipo di dati `timestamp` che la funzione converte in una stringa.  
Un valore letterale del timestamp Ion può essere indicato con backticks (). ``...`` Per dettagli sulla formattazione ed esempi di valori di timestamp, consulta [Timestamp](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) nel documento delle specifiche di Amazon Ion.

*format*  
La stringa letterale che specifica il modello di formato del risultato, in termini di parti relative alla data. Per i formati validi, consultare [stringhe in formato timestamp](ql-functions.timestamp-format.md).

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

`string`

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

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

# Funzione TO\$1TIMESTAMP in Amazon QLDB
<a name="ql-functions.to_timestamp"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, data una stringa che rappresenta un timestamp, usa `TO_TIMESTAMP` la funzione per convertire la stringa in un tipo di dati. `timestamp` Questa è l'operazione inversa di. `TO_STRING`

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

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

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

*string*  
Il nome di campo o l'espressione del tipo di dati `string` che la funzione converte in un timestamp.

*format*  
(Facoltativo) La stringa letterale che definisce il modello di formato dell'input*string*, in termini di parti di data. Per i formati validi, consultare [stringhe in formato timestamp](ql-functions.timestamp-format.md).  
Se questo argomento viene omesso, la funzione presuppone che *string* sia nel formato di un timestamp Ion [standard](http://amzn.github.io/ion-docs/docs/spec.html#timestamp). Questo è il metodo consigliato per analizzare un timestamp Ion utilizzando questa funzione.  
L'imbottitura zero è facoltativa quando si utilizza un simbolo di formato a carattere singolo (come`y`,,,`M`,,`d`,`H`,`s`) `h``m`, ma è obbligatoria per le varianti con imbottitura zero (ad esempio,,,,,,). `yyyy` `MM` `dd` `HH` `hh` `mm` `ss`  
Viene riservato un trattamento speciale agli anni a due cifre (simbolo di formato`yy`). 1900 viene aggiunto ai valori maggiori o uguali a 70 e 2000 viene aggiunto ai valori inferiori a 70.  
I nomi dei mesi e gli indicatori AM o PM non fanno distinzione tra maiuscole e minuscole.

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

`timestamp`

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

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

# Funzione TRIM in Amazon QLDB
<a name="ql-functions.trim"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

*In Amazon QLDB, usa `TRIM` la funzione per tagliare una determinata stringa rimuovendo gli spazi vuoti iniziali e finali o un set di caratteri specificato.*

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

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

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

LEADING  
(Facoltativo) Indica che gli spazi vuoti o i caratteri specificati devono essere rimossi dall'inizio di. *string* Se non viene specificato, il comportamento predefinito è`BOTH`.

TRAILING  
(Facoltativo) Indica che gli spazi vuoti o i caratteri specificati devono essere rimossi dalla fine di*string*. Se non viene specificato, il comportamento predefinito è`BOTH`.

BOTH  
(Facoltativo) Indica che gli spazi vuoti iniziali e finali o i caratteri specificati devono essere rimossi dall'inizio e dalla fine di*string*.

*characters*  
(Facoltativo) Il *set* di caratteri da rimuovere, specificato come a`string`.  
Se questo parametro non viene fornito, gli spazi vuoti vengono rimossi.

*string*  
Il nome di campo o l'espressione del tipo di dati `string` che la funzione elimina.

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

`string`

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

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

# Funzione TXID in Amazon QLDB
<a name="ql-functions.txid"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, utilizza `TXID` la funzione per restituire l'ID di transazione univoco dell'istruzione corrente che stai eseguendo. Questo è il valore assegnato al campo di `txId` metadati di un documento quando la transazione corrente viene salvata nel journal.

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

```
TXID()
```

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

Nessuno

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

`string`

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

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

# Funzione UPPER in Amazon QLDB
<a name="ql-functions.upper"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `UPPER` la funzione per convertire tutti i caratteri minuscoli in caratteri maiuscoli in una determinata stringa.

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

```
UPPER ( string )
```

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

*string*  
Il nome del campo o l'espressione del tipo di dati che la funzione converte. `string`

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

`string`

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

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

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

# Funzione UTCNOW in Amazon QLDB
<a name="ql-functions.utcnow"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `UTCNOW` la funzione per restituire l'ora corrente in Coordinated Universal Time (UTC) come. `timestamp`

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

```
UTCNOW()
```

Questa funzione richiede la specificazione di una `FROM` clausola in una query. `SELECT`

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

Nessuno

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

`timestamp`

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

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

# stringhe in formato timestamp
<a name="ql-functions.timestamp-format"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Questa sezione fornisce informazioni di riferimento per le stringhe in formato timestamp.

Le stringhe in formato timestamp si applicano alle funzioni and. `TO_STRING` `TO_TIMESTAMP` Queste stringhe possono contenere separatori di parti di data (come '', '`-`' o '`/``:`') e i seguenti simboli di formato.

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