Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función TO\$1JSON
<a name="TO_JSON"></a>

La función TO\$1JSON convierte una expresión de entrada en una representación de cadena JSON. La función gestiona la conversión de diferentes tipos de datos (como números, cadenas y valores booleanos) en sus correspondientes representaciones JSON.

La función TO\$1JSON resulta útil cuando se necesitan convertir datos estructurados (como filas de bases de datos u objetos JSON) a un formato más portátil y autodescriptivo, como JSON. Esto puede resultar especialmente útil cuando necesitas interactuar con otros sistemas o servicios que esperan datos con formato JSON.

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

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

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

*expr*  
La expresión de entrada que desea convertir en una cadena JSON. Puede ser un valor, una columna o cualquier otra expresión SQL válida.

*options*  
Un conjunto opcional de opciones de configuración que se puede utilizar para personalizar el proceso de conversión a JSON. Estas opciones pueden incluir aspectos como el manejo de valores nulos, la representación de valores numéricos y el tratamiento de los caracteres especiales.

## Devuelve
<a name="TO_JSON-returns"></a>

Devuelve una cadena JSON con un valor de estructura determinado

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

El siguiente ejemplo convierte una estructura con nombre (un tipo de datos estructurados) en una cadena JSON. El primer argumento `(named_struct('a', 1, 'b', 2)` () es la expresión de entrada que se pasa a la `to_json()` función. Crea una estructura con nombre con dos campos: «a» con un valor de 1 y «b» con un valor de 2. La función to\$1json () toma la estructura nombrada como argumento y la convierte en una representación de cadena JSON. El resultado es `{"a":1,"b":2}` una cadena JSON válida que representa la estructura nombrada.

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

El siguiente ejemplo convierte una estructura con nombre que contiene un valor de marca de tiempo en una cadena JSON, con un formato de marca de tiempo personalizado. El primer argumento (`named_struct('time', to_timestamp('2015-08-26', 'yyyy-MM-dd'))`) crea una estructura con nombre con un único campo «time» que contiene el valor de la marca de tiempo. El segundo argumento (`map('timestampFormat', 'dd/MM/yyyy')`) crea un mapa (diccionario clave-valor) con un único par clave-valor, donde la clave es 'TimestampFormat' y el valor es ''. 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 El resultado es `{"time":"26/08/2015"}` una cadena JSON con un solo campo «time» que contiene el valor de la marca de tiempo en el formato «» deseado. 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"}
```