Convertir CSV a JSON
Filas de hoja de cálculo en registros limpios

Qué hace esta herramienta para convertir CSV a JSON

Este conversor de CSV a JSON lee las filas de un archivo de hoja de cálculo y escribe cada una como un objeto JSON. La fila de arriba pone los nombres de campo; cada fila posterior pasa a ser un objeto. Tu navegador hace la lectura, así que el archivo nunca sale de tu ordenador.

El CSV parece sencillo, pero esconde trampas. Un nombre como "Ahmed, Bilal" lleva la misma coma que separa las columnas. Un código postal como 05400 pierde su cero si algo lo trata como número. Mientras tanto, una nota escrita en dos líneas parte el archivo en filas de más. Un conversor descuidado falla en las tres.

Este sigue las reglas que usan las hojas de cálculo al escribir CSV. Después muestra una tabla de comprobaciones: el delimitador detectado, las filas leídas y todo lo que tuvo que arreglar por el camino.

Leer el CSV como lo escriben las hojas de cálculo

El formato se describe en el estándar RFC 4180, y Excel, Google Sheets y LibreOffice lo siguen de cerca. Un campo entre comillas dobles puede contener comas, comillas e incluso saltos de línea. Dentro de ese campo, dos comillas seguidas equivalen a una comilla real.

El lector resuelve todos esos casos. Además, quita la marca invisible de orden de bytes que Excel añade al inicio de los archivos UTF-8. Si no, esa marca se colaría en el nombre de tu primera columna y rompería cada búsqueda sobre ella.

Convertir CSV a JSON con los tipos correctos

En un archivo CSV todo es texto. En cambio, JSON conoce los números, true y false, y null. Por eso el conversor mira cada valor. Un número simple se convierte en número JSON, y true o false en booleanos reales.

Aun así, algunos números deben seguir como texto. Un código postal o un teléfono con un cero inicial mantiene sus comillas, porque 05400 y 5400 son cosas distintas. De hecho, toda la columna sigue como texto, así que 05400 y 74000 nunca acaban con tipos diferentes. Igualmente, un ID de más de quince cifras queda como texto, ya que JavaScript lo redondearía. ¿Prefieres todo como cadenas? Entonces desactiva la detección de tipos.

Objetos anidados a partir de encabezados con puntos

Las tablas planas suelen representar datos anidados. Una columna llamada address.city significa en realidad "la ciudad dentro de la dirección". Activa los nombres con puntos y el conversor reconstruye esa estructura, así que address.city y address.zip terminan dentro de un mismo objeto address.

Es justo lo contrario de lo que hace nuestro conversor de JSON a CSV. Por eso puedes exportar JSON a una hoja, editarla con tu equipo y traerla de vuelta sin perder su forma.

Objetos o listas: elegir la forma del resultado

La mayoría del código quiere una lista de objetos, donde cada valor va junto a su nombre. Eso obtienes cuando la primera fila tiene los nombres. Sin embargo, algunas librerías de gráficos y herramientas de datos prefieren filas simples. Para ellas, desactiva la opción de encabezado y cada línea se convierte en una lista en el mismo orden que el archivo.

El formato del texto también lo eliges tú. Dos espacios van bien para un archivo que la gente leerá y editará. Cuatro espacios o tabuladores encajan con muchos estilos de código. Una sola línea sin espacios es la opción más pequeña, así que funciona mejor dentro de una petición a una API o de un valor de configuración.

Excel a JSON en dos movimientos

No hace falta ningún complemento ni macro. En Excel, elige Archivo, luego Guardar como, y selecciona CSV UTF-8. Después abre ese archivo aquí o pega su contenido. El JSON aparece enseguida.

En gran parte de Europa, Excel guarda con punto y coma en lugar de comas, porque la coma es su separador decimal. El conversor lo detecta solo y te dice qué delimitador usó. Aun así, puedes elegir uno a mano si un archivo es raro.

Qué pasa con las filas rotas

Los archivos editados a mano casi nunca son perfectos. Cuando una fila tiene menos campos que el encabezado, las claves que faltan quedan vacías y se cuentan en las comprobaciones. Cuando una comilla se abre y nunca se cierra, el conversor se detiene y nombra la línea exacta, porque adivinar ahí desordenaría todas las filas siguientes.

Quién convierte hojas de cálculo en JSON

Quien programa lo necesita casi cada día. Una lista de productos guardada en una hoja se convierte en datos iniciales para una base de datos. Una tabla de traducciones se convierte en un archivo de idioma. Por ejemplo, una diseñadora puede pasar una hoja de usuarios de prueba, y un desarrollador puede cargarla en una API simulada un minuto después.

También ayuda a quien nunca programa. Muchos creadores de webs, herramientas de formularios y servicios de automatización aceptan importar JSON. Así, una lista de ventas o un calendario de eventos pasa de una hoja a esas herramientas sin volver a escribir ni una fila. La guía de JSON de MDN es un buen sitio para entender el resultado.