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.

# TO\$1JSON-Funktion
<a name="TO_JSON"></a>

Die TO\$1JSON-Funktion konvertiert einen Eingabeausdruck in eine JSON-Zeichenfolgendarstellung. Die Funktion verarbeitet die Konvertierung verschiedener Datentypen (wie Zahlen, Zeichenketten und Boolesche Werte) in die entsprechenden JSON-Repräsentationen.

Die TO\$1JSON-Funktion ist nützlich, wenn Sie strukturierte Daten (wie Datenbankzeilen oder JSON-Objekte) in ein portableres, sich selbst beschreibendes Format wie JSON konvertieren müssen. Dies kann besonders hilfreich sein, wenn Sie mit anderen Systemen oder Diensten interagieren müssen, die Daten im JSON-Format erwarten.

## Syntax
<a name="TO_JSON-syntax"></a>

```
to_json(expr[, options])
```

## Argumente
<a name="TO_JSON-arguments"></a>

*expr*  
Der Eingabeausdruck, den Sie in eine JSON-Zeichenfolge konvertieren möchten. Es kann ein Wert, eine Spalte oder ein anderer gültiger SQL-Ausdruck sein.

*options*  
Ein optionaler Satz von Konfigurationsoptionen, mit denen der JSON-Konvertierungsprozess angepasst werden kann. Diese Optionen können Dinge wie die Behandlung von Nullwerten, die Darstellung numerischer Werte und die Behandlung von Sonderzeichen beinhalten.

## Rückgabewert
<a name="TO_JSON-returns"></a>

Gibt eine JSON-Zeichenfolge mit einem bestimmten Strukturwert zurück

## Beispiele
<a name="TO_JSON-examples"></a>

Das folgende Beispiel konvertiert eine benannte Struktur (eine Art strukturierter Daten) in eine JSON-Zeichenfolge. Das erste Argument `(named_struct('a', 1, 'b', 2)` () ist der Eingabeausdruck, der an die `to_json()` Funktion übergeben wird. Es erstellt eine benannte Struktur mit zwei Feldern: „a“ mit einem Wert von 1 und „b“ mit einem Wert von 2. Die Funktion to\$1json () verwendet die benannte Struktur als Argument und konvertiert sie in eine JSON-Zeichenkettendarstellung. Die Ausgabe ist eine gültige JSON-Zeichenfolge`{"a":1,"b":2}`, die die benannte Struktur darstellt.

```
SELECT to_json(named_struct('a', 1, 'b', 2));
 {"a":1,"b":2}
```

Das folgende Beispiel konvertiert eine benannte Struktur, die einen Zeitstempelwert enthält, in eine JSON-Zeichenfolge mit einem benutzerdefinierten Zeitstempelformat. Das erste Argument (`named_struct('time', to_timestamp('2015-08-26', 'yyyy-MM-dd'))`) erstellt eine benannte Struktur mit einem einzigen Feld „time“, das den Zeitstempelwert enthält. Das zweite Argument (`map('timestampFormat', 'dd/MM/yyyy')`) erstellt eine Map (Schlüssel-Wert-Wörterbuch) mit einem einzigen Schlüssel-Wert-Paar, wobei der Schlüssel 'TimeStampFormat' und der Wert '' ist. dd/MM/yyyy'. This map is used to specify the desired format for the timestamp value when converting it to JSON. The to\$1json() function converts the named struct into a JSON string. The second argument, the map, is used to customize the timestamp format to 'dd/MM/yyyy Die Ausgabe ist eine JSON-Zeichenfolge mit einem einzigen Feld „Zeit“`{"time":"26/08/2015"}`, das den Zeitstempelwert im gewünschten Format „“ enthält. dd/MM/yyyy

```
SELECT to_json(named_struct('time', to_timestamp('2015-08-26', 'yyyy-MM-dd')), map('timestampFormat', 'dd/MM/yyyy'));
 {"time":"26/08/2015"}
```