Cómo convertir JSON y CSV
Selecciona una dirección y pega los datos. JSON a CSV exige una matriz de objetos. CSV a JSON usa la primera fila como cabecera y conserva las celdas no vacías como cadenas para no adivinar números o fechas.
- En JSON a CSV, proporciona una matriz de objetos; las cabeceras se recopilan por primera aparición.
- Decide si objetos y matrices anidados se guardan como texto JSON o se rechazan.
- Mantén la protección de fórmulas si el archivo se abrirá en Excel, LibreOffice u otra hoja.
- En CSV a JSON, elige si una celda vacía se vuelve null o cadena vacía y revisa filas y campos multilínea.
Ejemplos y comportamiento esperado
| Entrada | Salida | Notas |
|---|---|---|
[{"name":"Jane","age":30}] |
name,age
Jane,30 |
Los campos escalares se convierten en columnas y se usa CRLF. |
[{"name":"Doe, Jane","note":"She said \"hi\""}] |
name,note
"Doe, Jane","She said ""hi""" |
Comas y comillas se citan y escapan. |
name,note
Jane,"Línea 1
Línea 2" |
[{"name":"Jane","note":"Línea 1\r\nLínea 2"}] |
Un salto dentro de un campo citado forma parte del valor. |
name,value
泉, |
[{"name":"泉","value":null}] |
La política null convierte una celda vacía en JSON null. |
[{"cell":"=2+3"}] |
cell
'=2+3 |
La protección añade un apóstrofo a texto con forma de fórmula. |
[{"meta":{"ok":true}}] |
meta
"{""ok"":true}" |
Un valor anidado puede guardarse como JSON dentro de una celda. |
Forma JSON y selección de cabeceras
La entrada debe ser una matriz superior y cada elemento un objeto no nulo. Se recorren los registros en orden y cada propiedad nueva se añade a la cabecera. Las propiedades ausentes producen celdas vacías.
CSV es tabular y los objetos JSON pueden variar por fila. Un conjunto irregular crea muchas columnas vacías; conviene normalizar el esquema. En la importación se rechazan cabeceras duplicadas porque no se pueden mapear de forma inequívoca.
- La raíz debe ser una matriz de objetos.
- Las cabeceras son la unión de propiedades por primera aparición.
- null y propiedades ausentes producen celdas vacías.
Comillas y finales de línea estilo RFC 4180
El escritor usa comas y CRLF. Un campo se cita si contiene coma, comilla, retorno, salto o espacios al inicio o final. Dentro de un campo citado, una comilla se duplica.
El parser acepta CRLF, LF o CR y conserva saltos dentro de comillas. Rechaza comillas sin cerrar, comillas inesperadas y caracteres tras una comilla de cierre. Los dialectos con punto y coma o tabulador quedan fuera.
- Un salto citado no termina la fila.
- Dos comillas consecutivas representan una comilla literal.
- La exportación siempre usa coma y CRLF.
Celdas vacías, tipos y anidados
CSV no tiene tipos ni un null universal. La importación conserva cada celda no vacía como cadena y permite convertir el vacío en null o cadena vacía. No convierte 00123 a número ni interpreta fechas, evitando pérdida de ceros y errores regionales.
En exportación, cadenas, números finitos y booleanos se vuelven texto; null queda vacío. Objetos y matrices se serializan como JSON compacto o se rechazan según la opción. Guardarlos en una celda no los normaliza en columnas relacionales.
- Elige null si ausencia y texto vacío deben diferenciarse.
- Elige cadena vacía para un modelo completamente textual.
- Rechaza anidados si el destino exige un esquema plano.
Inyección de fórmulas de hoja de cálculo
Aplicaciones de hojas pueden interpretar celdas que empiezan por =, +, -, @, tabulador o retorno como fórmulas. Con datos no fiables esto puede provocar cálculos o enlaces inesperados. Por defecto se antepone un apóstrofo.
El apóstrofo modifica el valor exportado, así que es una decisión de política. Déjalo activo para archivos que abrirán personas; desactívalo solo si el receptor trata CSV estrictamente como datos y necesita el carácter inicial exacto. Citar el campo no basta para detener fórmulas.
- La protección se aplica a cabeceras y celdas.
- Se considera el espacio inicial antes del carácter peligroso.
- Mantén actualizado el software de hoja de cálculo.
Usos y revisión
Sirve para exportar pequeños conjuntos de API, crear fixtures JSON desde muestras, preparar contactos o inventario y revisar archivos de proveedores. Funciona mejor con datos planos y un esquema conocido.
Después revisa cabeceras, número de filas, vacíos, saltos y celdas JSON anidadas. Las importaciones críticas requieren validación de columnas y tipos en el destino. Para grandes volúmenes usa herramientas en streaming.
- Crear fixtures con comillas correctas.
- Exportar registros para revisión puntual.
- Verificar comas y saltos de línea.
- Comprobar protección de fórmulas.
Errores e interoperabilidad
Se informan comillas dañadas, cabeceras ausentes o duplicadas y filas con distinto número de campos. En exportación se detectan JSON inválido, raíz no matricial, filas no objeto y anidados rechazados.
Los dialectos CSV varían: punto y coma, UTF-16, BOM, coma decimal o reglas no estándar. Esta página emite UTF-8 sin BOM y un dialecto con comas estilo RFC 4180. Prueba con el destino real.
- No admite comentarios ni varias secciones de cabecera.
- Analizar no valida correos, fechas o números.
- La memoria del navegador fija el límite práctico.
Diferencias con JSON y YAML
El formateador JSON conserva anidación y cambia presentación; JSON/YAML conserva anidación y cambia sintaxis. CSV necesita una tabla compartida, por lo que exige una política para anidados.
Usa importadores de base de datos para esquemas y millones de filas, y bibliotecas XLSX para hojas, tipos y fórmulas. Esta herramienta está pensada para transformaciones de texto pequeñas y auditables.