Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

PartiQL in Amazon QLDB unterstützt die folgenden integrierten Varianten von SQL-Standardfunktionen.

**Anmerkung**  
Alle SQL-Funktionen, die nicht in dieser Liste enthalten sind, werden derzeit in QLDB nicht unterstützt.  
Diese Funktionsreferenz basiert auf der PartiQL-Dokumentation [Built-In Functions](https://github.com/partiql/partiql-lang-kotlin/blob/main/docs/wiki/documentation/Functions.md#built-in-functions).

**Unbekannter Typ (Null und fehlende) Propagierung**

Sofern nicht anders angegeben, propagieren alle diese Funktionen Null- und fehlende Argumentwerte. *Propagierung* von `NULL` oder `MISSING` wird als Rückgabe von `NULL` definiert, wenn ein Funktionsargument entweder `NULL` oder `MISSING` ist. Es folgen Beispiele für diese Propagierung.

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

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

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

## Datums- und Zeitfunktionen
<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)

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

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

## Funktionen für die Datentypformatierung
<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)

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `AVG` Funktion, um den Durchschnitt (arithmetisches Mittel) der eingegebenen Ausdruckswerte zurückzugeben. Diese Funktion arbeitet mit numerischen Werten und ignoriert Nullwerte oder fehlende Werte.

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

```
AVG ( expression )
```

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

*expression*  
Der Feldname oder der Ausdruck eines numerischen Datentyps, auf dem die Funktion arbeitet.

## Datentypen
<a name="ql-functions.avg.data-types"></a>

Unterstützte Argumenttypen:
+ `int`
+ `decimal`
+ `float`

Typ der Rückgabe: `decimal`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `CAST` Funktion, um einen bestimmten Ausdruck in einen Wert auszuwerten und den Wert in einen bestimmten Zieldatentyp zu konvertieren. Wenn die Konvertierung nicht durchgeführt werden kann, gibt die Funktion einen Fehler zurück.

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

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

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

*expression*  
Der Feldname oder der Ausdruck, der zu einem Wert ausgewertet wird, den die Funktion umwandelt. Die Konvertierung von Null-Werten gibt Null-Werte zurück. Dieser Parameter kann jeder der unterstützten [Datentypen](ql-reference.data-types.md) sein.

*type*  
Der Name des Zieldatentyps für die Umwandlung. Bei diesem Parameter kann es sich um einen der unterstützten [Datentypen](ql-reference.data-types.md) handeln.

## Rückgabetyp
<a name="ql-functions.cast.return-type"></a>

Der Datentyp, der durch das *type* Argument angegeben wird.

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

Die folgenden Beispiele zeigen die Propagierung unbekannter Typen (`NULL` oder `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)
```

Jeder Wert, der kein unbekannter Typ ist, kann nicht in `NULL` oder umgewandelt werden`MISSING`.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS boolean` veranschaulicht.

```
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'`)
```

In den nachstehenden Beispielen wird die Umwandlung von `AS integer` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS float` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS decimal` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS timestamp` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS symbol` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS string` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS struct` veranschaulicht.

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

In den nachstehenden Beispielen wird die Umwandlung von `AS list` veranschaulicht.

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

Bei den folgenden Beispielen handelt es sich um ausführbare Anweisungen, die einige der vorherigen Beispiele enthalten.

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `CHAR_LENGTH` Funktion, um die Anzahl der Zeichen in der angegebenen Zeichenfolge zurückzugeben, wobei das *Zeichen* als einzelner Unicode-Codepunkt definiert ist.

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

```
CHAR_LENGTH ( string )
```

`CHAR_LENGTH` ist ein Synonym für [CHARACTER\$1LENGTH-Funktion in Amazon QLDB](ql-functions.character_length.md).

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

*string*  
Der Feldname oder Ausdruck des Datentyps `string`, den die Funktion auswertet.

## Rückgabetyp
<a name="ql-functions.char_length.return-type"></a>

`int`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Synonym mit der Funktion `CHAR_LENGTH`.

Siehe [CHAR\$1LENGTH-Funktion in Amazon QLDB](ql-functions.char_length.md).

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB anhand einer Liste mit einem oder mehreren Argumenten die `COALESCE` Funktion, um die Argumente in der Reihenfolge von links nach rechts auszuwerten und den ersten Wert zurückzugeben, der kein unbekannter Typ ist (`NULL`oder`MISSING`). Wenn alle Argumenttypen unbekannt sind, ist das Ergebnis `NULL`.

Die `COALESCE` Funktion propagiert `NULL` nicht und. `MISSING`

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

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

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

*expression*  
Die Liste der Feldnamen oder Ausdrücke, die von der Funktion ausgewertet werden. Jedes Argument kann ein beliebiges der unterstützten [Datentypen](ql-reference.data-types.md) sein.

## Rückgabetyp
<a name="ql-functions.coalesce.return-type"></a>

Beliebiger unterstützter Datentyp. Der Rückgabetyp ist entweder `NULL` oder entspricht dem Typ des ersten Ausdrucks, der zu einem Nicht-Null- und nicht fehlenden Wert ausgewertet wird.

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `COUNT` Funktion, um die Anzahl der Dokumente zurückzugeben, die durch den angegebenen Ausdruck definiert sind. Diese Funktion hat zwei Varianten:
+ `COUNT(*)`— Zählt alle Dokumente in der Zieltabelle, unabhängig davon, ob sie Nullwerte oder fehlende Werte enthalten oder nicht.
+ `COUNT(expression)`— Berechnet die Anzahl der Dokumente mit Werten ungleich Null in einem bestimmten, vorhandenen Feld oder Ausdruck.

**Warnung**  
Die `COUNT` Funktion ist nicht optimiert, daher empfehlen wir nicht, sie ohne eine indizierte Suche zu verwenden. Wenn Sie eine Abfrage in QLDB ohne indizierte Suche ausführen, wird ein vollständiger Tabellenscan aufgerufen. Dies kann bei großen Tabellen zu Leistungsproblemen führen, einschließlich Parallelitätskonflikten und Transaktions-Timeouts.  
Um Tabellenscans zu vermeiden, müssen Sie Anweisungen mit einer `WHERE` Prädikatklausel unter Verwendung eines *Gleichheitsoperators* (`=`oder`IN`) für ein indiziertes Feld oder eine Dokument-ID ausführen. Weitere Informationen finden Sie unter [Optimieren der Abfrageleistung](working.optimize.md).

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

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

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

*expression*  
Der Feldname oder der Ausdruck, auf dem die Funktion arbeitet. Dieser Parameter kann jeder der unterstützten [Datentypen](ql-reference.data-types.md) sein.

## Rückgabetyp
<a name="ql-functions.count.return-type"></a>

`int`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `DATE_ADD` Funktion, um einen bestimmten Zeitstempelwert um ein bestimmtes Intervall zu erhöhen.

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

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

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

*datetimepart*  
Der Datums- oder Uhrzeitteil, an dem die Funktion ausgeführt wird. Bei diesem Parameter kann es sich um einen der Folgenden handeln:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*interval*  
Die Ganzzahl, die das Intervall angibt, das zum angegebenen Wert hinzugefügt werden soll*timestamp*. Bei einer negativen Ganzzahl wird das Intervall subtrahiert.

*timestamp*  
Der Feldname oder Ausdruck des Datentyps `timestamp`, den die Funktion erhöht.  
Ein Ion-Zeitstempel-Literalwert kann mit Backticks () bezeichnet werden. ``...`` Formatierungsdetails und Beispiele für Zeitstempelwerte finden Sie unter [Zeitstempel](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) im Amazon Ion-Spezifikationsdokument.

## Rückgabetyp
<a name="ql-functions.date_add.return-type"></a>

`timestamp`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `DATE_DIFF` Funktion, um die Differenz zwischen den angegebenen Datumsteilen zweier gegebener Zeitstempel zurückzugeben.

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

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

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

*datetimepart*  
Der Datums- oder Uhrzeitteil, an dem die Funktion ausgeführt wird. Bei diesem Parameter kann es sich um einen der Folgenden handeln:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*timestamp1*, *timestamp2*  
Die beiden Feldnamen oder Ausdrücke des Datentyps `timestamp`, die die Funktion vergleicht. Wenn *timestamp2* es später ist als*timestamp1*, ist das Ergebnis positiv. Wenn *timestamp2* es früher ist als*timestamp1*, ist das Ergebnis negativ.  
Ein Ion-Zeitstempel-Literalwert kann mit Backticks () bezeichnet werden. ``...`` Formatierungsdetails und Beispiele für Zeitstempelwerte finden Sie unter [Zeitstempel](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) im Amazon Ion-Spezifikationsdokument.

## Rückgabetyp
<a name="ql-functions.date_diff.return-type"></a>

`int`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB bei einem gegebenen PartiQL-Wert die `EXISTS` Funktion, um zurückzugeben, `TRUE` ob es sich bei dem Wert um eine nicht leere Sammlung handelt. Andernfalls kehrt diese Funktion zurück. `FALSE` Wenn die Eingabe zu `EXISTS` kein Container ist, ist das Ergebnis `FALSE`.

Die `EXISTS` Funktion verbreitet sich nicht `NULL` und`MISSING`.

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

```
EXISTS ( value )
```

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

*value*  
Der Feldname oder der Ausdruck, den die Funktion auswertet. Dieser Parameter kann jeder der unterstützten [Datentypen](ql-reference.data-types.md) sein.

## Rückgabetyp
<a name="ql-functions.exists.return-type"></a>

`bool`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `EXTRACT` Funktion, um den Ganzzahlwert eines bestimmten Datums- oder Zeitabschnitts aus einem bestimmten Zeitstempel zurückzugeben.

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

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

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

*datetimepart*  
Der Datums- oder Uhrzeitteil, den die Funktion extrahiert. Bei diesem Parameter kann es sich um einen der Folgenden handeln:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`
+ `timezone_hour`
+ `timezone_minute`

*timestamp*  
Der Feldname oder Ausdruck des Datentyps `timestamp`, aus dem die Funktion extrahiert. Wenn dieser Parameter ein unbekannter Typ (`NULL` oder `MISSING`) ist, gibt die Funktion `NULL` zurück.  
Ein Ion-Zeitstempel-Literalwert kann mit Backticks () bezeichnet werden. ``...`` Formatierungsdetails und Beispiele für Zeitstempelwerte finden Sie unter [Zeitstempel](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) im Amazon Ion-Spezifikationsdokument.

## Rückgabetyp
<a name="ql-functions.extract.return-type"></a>

`int`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `LOWER` Funktion, um alle Großbuchstaben in Kleinbuchstaben in einer bestimmten Zeichenfolge umzuwandeln.

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

```
LOWER ( string )
```

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

*string*  
Der Feldname oder Ausdruck des Datentyps `string`, den die Funktion umwandelt.

## Rückgabetyp
<a name="ql-functions.lower.return-type"></a>

`string`

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

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `MAX` Funktion, um den Maximalwert in einer Reihe von numerischen Werten zurückzugeben.

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

```
MAX ( expression )
```

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

*expression*  
Der Feldname oder der Ausdruck eines numerischen Datentyps, auf dem die Funktion arbeitet.

## Datentypen
<a name="ql-functions.max.data-types"></a>

Unterstützte Argumenttypen:
+ `int`
+ `decimal`
+ `float`

Unterstützte Rückgabetypen:
+ `int`
+ `decimal`
+ `float`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `MIN` Funktion, um den Mindestwert in einer Reihe von numerischen Werten zurückzugeben.

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

```
MIN ( expression )
```

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

*expression*  
Der Feldname oder der Ausdruck eines numerischen Datentyps, auf dem die Funktion arbeitet.

## Datentypen
<a name="ql-functions.min.data-types"></a>

Unterstützte Argumenttypen:
+ `int`
+ `decimal`
+ `float`

Unterstützte Rückgabetypen:
+ `int`
+ `decimal`
+ `float`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB bei Angabe von zwei Ausdrücken die `NULLIF` Funktion, um zurückzugeben, `NULL` ob die beiden Ausdrücke denselben Wert ergeben. Andernfalls gibt diese Funktion das Ergebnis der Auswertung des ersten Ausdrucks zurück.

Die `NULLIF` Funktion propagiert `NULL` und `MISSING` nicht.

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

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

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

*expression1*, *expression2*  
Die beiden Feldnamen oder Ausdrücke, die die Funktion vergleicht. Diese Parameter können jeder der unterstützten [Datentypen](ql-reference.data-types.md) sein.

## Rückgabetyp
<a name="ql-functions.nullif.return-type"></a>

Beliebiger unterstützter Datentyp. Der Rückgabetyp ist `NULL` oder mit dem Typ des ersten Ausdrucks identisch.

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `SIZE` Funktion, um die Anzahl der Elemente in einem bestimmten Container-Datentyp (Liste, Struktur oder Beutel) zurückzugeben.

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

```
SIZE ( container )
```

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

*container*  
Der Containerfeldname oder -ausdruck, auf dem die Funktion arbeitet.

## Datentypen
<a name="ql-functions.size.data-types"></a>

Unterstützte Argumenttypen:
+ auflisten
+ Struktur
+ Tasche

Typ der Rückgabe: `int`

Wenn die Eingabe zu `SIZE` kein Container ist, löst die Funktion einen Fehler aus.

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `SUBSTRING` Funktion, um eine Teilzeichenfolge aus einer bestimmten Zeichenfolge zurückzugeben. Die Teilzeichenfolge beginnt mit dem angegebenen Startindex und endet mit dem letzten Zeichen der Zeichenfolge oder bei der angegebenen Länge.

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

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

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

*string*  
Der Feldname oder Ausdruck des Datentyps `string`, aus dem eine Teilzeichenfolge extrahiert werden soll.

*start-index*  
Die Startposition innerhalb der, *string* von der aus die Extraktion beginnen soll. Diese Zahl kann negativ sein.  
Das erste Zeichen von *string* hat den Index 1.

*length*  
(Optional) Die Anzahl der Zeichen (Codepunkte)*string*, die aus dem extrahiert werden sollen, beginnend mit *start-index* und endend bei (*start-index*\$1*length*) — 1. Mit anderen Worten, die Länge der Teilzeichenfolge. Diese Zahl darf nicht negativ sein.  
Wenn dieser Parameter nicht angegeben wird, fährt die Funktion bis zum Ende von fort*string*.

## Rückgabetyp
<a name="ql-functions.substring.return-type"></a>

`string`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `SUM` Funktion, um die Summe der Eingabefeld- oder Ausdruckswerte zurückzugeben. Diese Funktion arbeitet mit numerischen Werten und ignoriert Nullwerte oder fehlende Werte.

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

```
SUM ( expression )
```

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

*expression*  
Der Feldname oder der Ausdruck eines numerischen Datentyps, auf dem die Funktion arbeitet.

## Datentypen
<a name="ql-functions.sum.data-types"></a>

Unterstützte Argumenttypen:
+ `int`
+ `decimal`
+ `float`

Unterstützte Rückgabetypen:
+ `int`— Für Integer-Argumente
+ `decimal`— Für Dezimal- oder Fließkomma-Argumente

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `TO_STRING` Funktion, um eine Zeichenkettendarstellung eines bestimmten Zeitstempels im angegebenen Formatmuster zurückzugeben.

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

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

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

*timestamp*  
Der Feldname oder Ausdruck des Datentyps `timestamp`, den die Funktion in eine Zeichenfolge umwandelt.  
Ein Ion-Zeitstempel-Literalwert kann mit Backticks () bezeichnet werden. ``...`` Formatierungsdetails und Beispiele für Zeitstempelwerte finden Sie unter [Zeitstempel](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) im Amazon Ion-Spezifikationsdokument.

*format*  
Der Zeichenfolgenliteralwert, der das Formatmuster des Ergebnisses in Bezug auf seine Datumsteile angibt. Informationen zu gültigen Formaten finden Sie unter [Zeichenketten im Timestamp-Format](ql-functions.timestamp-format.md).

## Rückgabetyp
<a name="ql-functions.to_string.return-type"></a>

`string`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB bei einer gegebenen Zeichenfolge, die einen Zeitstempel darstellt, die `TO_TIMESTAMP` Funktion, um die Zeichenfolge in einen `timestamp` Datentyp zu konvertieren. Das ist der umgekehrte Vorgang von `TO_STRING`.

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

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

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

*string*  
Der Feldname oder Ausdruck des Datentyps `string`, den die Funktion in einen Zeitstempel umwandelt.

*format*  
(Optional) Das Zeichenkettenliteral, das das Formatmuster der Eingabe in Bezug auf ihre *string* Datumsteile definiert. Informationen zu gültigen Formaten finden Sie unter [Zeichenketten im Timestamp-Format](ql-functions.timestamp-format.md).  
Wenn dieses Argument weggelassen wird, geht die Funktion davon aus, dass *string* das Format eines [Standard-Ion-Zeitstempels](http://amzn.github.io/ion-docs/docs/spec.html#timestamp) hat. Dies ist die empfohlene Methode, einen Ion-Zeitstempel mit dieser Funktion zu analysieren.  
Auffüllung mit Nullen ist optional, wenn ein Ein-Zeichen-Formatsymbol (wie `y`, `M`, `d`, `H`, `h`, `m`, `s`) verwendet wird, aber für mit Nullen aufgefüllte Varianten (wie `yyyy`, `MM`, `dd`, `HH`, `hh`, `mm`, `ss`) erforderlich.  
Zweistellige Jahreszahlen werden besonders behandelt (Formatsymbol`yy`). 1900 wird zu Werten hinzugefügt, die größer oder gleich 70 sind, und 2000 wird zu Werten unter 70 addiert.  
Monatsnamen und AM- oder PM-Indikatoren unterscheiden nicht zwischen Groß- und Kleinschreibung.

## Rückgabetyp
<a name="ql-functions.to_timestamp.return-type"></a>

`timestamp`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `TRIM` Funktion, um eine bestimmte Zeichenfolge zu kürzen, indem Sie die führenden und nachfolgenden Leerzeichen oder eine bestimmte *Gruppe* von Zeichen entfernen.

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

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

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

LEADING  
(Optional) Gibt an, dass die Leerzeichen oder angegebenen Zeichen am Anfang von entfernt werden sollen. *string* Wenn nicht angegeben, ist das Standardverhalten `BOTH`.

TRAILING  
(Optional) Gibt an, dass die Leerzeichen oder angegebenen Zeichen am Ende von entfernt werden sollen*string*. Wenn nicht angegeben, ist das Standardverhalten `BOTH`.

BOTH  
(Optional) Gibt an, dass sowohl die führenden als auch die nachfolgenden Leerzeichen oder angegebenen Zeichen am Anfang und Ende von *string* entfernt werden sollen.

*characters*  
(Optional) Der *Satz* der zu entfernenden Zeichen, angegeben als `string`.  
Wenn dieser Parameter nicht angegeben wird, werden Leerzeichen entfernt.

*string*  
Der Feldname oder Ausdruck des Datentyps `string`, den die Funktionen kürzt.

## Rückgabetyp
<a name="ql-functions.trim.return-type"></a>

`string`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `TXID` Funktion, um die eindeutige Transaktions-ID der aktuellen Anweisung zurückzugeben, die Sie gerade ausführen. Dies ist der Wert, der dem `txId`-Metadatenfeld eines Dokuments zugewiesen wird, wenn die aktuelle Transaktion an das Journal übergeben wird.

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

```
TXID()
```

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

Keine

## Rückgabetyp
<a name="ql-functions.txid.return-type"></a>

`string`

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `UPPER` Funktion, um alle Kleinbuchstaben in einer bestimmten Zeichenfolge in Großbuchstaben umzuwandeln.

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

```
UPPER ( string )
```

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

*string*  
Der Feldname oder Ausdruck des Datentyps `string`, den die Funktion umwandelt.

## Rückgabetyp
<a name="ql-functions.upper.return-type"></a>

`string`

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

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

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

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `UTCNOW` Funktion, um die aktuelle Uhrzeit in Coordinated Universal Time (UTC) als zurückzugeben. `timestamp`

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

```
UTCNOW()
```

Für diese Funktion müssen Sie eine `FROM` Klausel in einer `SELECT` Abfrage angeben.

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

Keine

## Rückgabetyp
<a name="ql-functions.utcnow.return-type"></a>

`timestamp`

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

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

# Zeichenketten im Timestamp-Format
<a name="ql-functions.timestamp-format"></a>

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Dieser Abschnitt enthält Referenzinformationen für Zeitstempel-Formatzeichenfolgen.

Zeitstempel-Formatzeichenfolgen gelten für die Funktionen `TO_STRING` und `TO_TIMESTAMP`. Diese Zeichenfolgen können Datumsteiltrennzeichen (wie`-`, `/` oder `:`) und die folgenden Formatsymbole enthalten.

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