Excel a JSON

¿Se incluyen las celdas vacías?

Sí, como null. Todas las filas de una hoja tienen las mismas claves, así que el código que lee una propiedad Note encuentra null en lugar de una clave ausente. Las filas totalmente vacías se omiten.

¿Las fechas se convierten en texto?

Sí, a ISO 8601: 2024-01-15, o 2024-02-29T13:45:00 cuando la celda tiene hora, sin añadir zona horaria. Sin este paso, una fecha de Excel saldría como un número de serie, por ejemplo 45306.

¿Puedo elegir qué hojas convertir?

No. Se convierten todas las hojas, incluidas las ocultas, cada una con su propio nombre en el JSON. Borra después los arrays que no necesites, o guarda antes las hojas que quieras en un libro aparte.

¿Se conservan los encabezados de columna repetidos?

Sí. Cuando dos columnas tienen el mismo encabezado, por ejemplo name, la segunda pasa a ser name_1 en cada objeto de fila, así que no se sobrescribe ningún valor.

¿La fila de encabezado tiene que ser la primera fila?

Sí. La primera fila del área usada de la hoja da las claves, así que un título como Informe de ventas 2024 escrito encima de la tabla se convierte en una clave y los encabezados reales pasan a ser una fila de datos. Borra las filas que haya encima de los encabezados antes de convertir.

¿Qué pasa con una columna cuya celda de encabezado está vacía?

Se conserva con la clave __EMPTY, y luego __EMPTY_1 y __EMPTY_2 para las siguientes, así que no se pierde ningún valor. Escribe antes un encabezado en esa celda si tu código necesita un nombre con sentido.

¿Los porcentajes y los importes se conservan tal como se muestran?

No, se escribe el número guardado: una celda que muestra 50 % da 0.5, y una que muestra 9,99 € da 9.99. Las celdas VERDADERO y FALSO pasan a ser true y false, y un número escrito en una celda con formato Texto, como 007, sigue siendo una cadena.

¿Qué pasa con las celdas combinadas?

El valor va a la primera fila del área combinada, y las demás filas que abarca reciben null. Separa antes las celdas y rellena hacia abajo en Excel si cada fila necesita el valor.

¿Qué dan los errores de fórmula como #N/A o #DIV/0!?

null, igual que una celda vacía, así que el texto del error no aparece en el JSON. Una fórmula guardada sin su resultado, como en un archivo escrito con openpyxl de Python que aún no se ha abierto y guardado en Excel, también da null. Busca # en la hoja antes de convertir si un error no debe pasar desapercibido.

¿Por qué las columnas con los encabezados 2023 y 2024 aparecen primero en cada objeto?

JavaScript pone primero las claves que son números enteros, en orden ascendente, sea cual sea el orden de las columnas: Region | 2023 | 2024 se escribe "2023", "2024", "Region". Los valores siguen con sus claves correctas; solo cambia su orden en el archivo. Cambia el nombre de esos encabezados, por ejemplo a Ejercicio2024, si un programa depende del orden de las claves.

¿Un encabezado como user.name crea objetos anidados?

No. Cada clave es el texto del encabezado tal como se escribió, así que user.name y user.age son dos claves simples del mismo objeto de fila. Los espacios también se conservan: un encabezado escrito como Name seguido de un espacio da la clave "Name ", que un código que busca Name no encontrará.

¿Se incluyen las hojas, filas y columnas ocultas?

Sí. Las hojas ocultas, las filas ocultas, las columnas ocultas y las filas ocultas por un filtro se convierten igual que las visibles. Bórralas antes en el libro si no deben estar en el JSON.

¿Qué da una hoja que solo tiene la fila de encabezado?

Un array vacío, como una hoja vacía: sin ninguna fila de datos debajo, los nombres de los encabezados no se escriben en ninguna parte del JSON.

¿Puedo obtener JSON minificado o un array de arrays?

No desde esta página: el archivo es siempre un objeto con un array por hoja, con una sangría de dos espacios. Pégalo en «Minificador JSON» para quitar los espacios. Para un array de arrays o JSON Lines, guarda la hoja con «Excel a CSV» y convierte ese archivo con «CSV a JSON».

¿Puedo convertir un archivo de Apple Numbers?

Sí. Un archivo .numbers de Numbers 2013 o posterior, uno más antiguo de Numbers ’08 o ’09, y un documento de Numbers guardado como carpeta, una vez comprimido en ZIP (Nombre.numbers.zip), se leen todos en tu navegador. Cada tabla se convierte en su propio array, con el nombre de su hoja. Cuando una hoja contiene varias tablas, un archivo de Numbers ’08 o ’09 las llama «hoja - tabla», y uno más reciente las llama hoja, hoja_1, etc.

¿Qué tamaño puede tener el archivo?

90 MB y 150 000 filas, contando todas las hojas, en una computadora; 30 MB y 50 000 filas en teléfonos y tabletas. Divide un libro más grande en varios archivos y conviértelos uno por uno.