Convertitore da Excel a JSON

Cos'è la conversione da XLSX a JSON e perché è diversa da CSV

Convertire un file Excel (XLSX) in JSON non è la stessa cosa che esportare in CSV. Un file XLSX è un archivio ZIP che contiene una struttura XML complessa: può avere più fogli di lavoro, tipi di cella distinti (testo, numero, data, booleano), formule, formattazione ricca e celle unite. JSON, invece, è un formato testuale che supporta tipi nativi: oggetti, array, numeri (integer e float), booleani (true/false) e null. Questa differenza è il cuore del motivo per cui uno strumento specializzato per XLSX → JSON esiste.

Quando si esporta in CSV, ogni cella viene forzata in una stringa di testo tra virgolette. I numeri diventano cifre scritte, i booleani diventano le parole “TRUE” o “FALSE”, le date si trasformano in stringhe (spesso in formato locale). Il programma che consumerà il CSV dovrà poi riconvertire quei valori – un passaggio soggetto a errori di parsing, fusi orari e differenze di lingua.

In JSON, invece, i valori numerici e booleani possono essere preservati come tipi nativi. Se una cella Excel contiene il numero 42.5, nel JSON finale apparirà come il numero 42.5, non come la stringa "42.5". Se una cella contiene un valore booleano (a volte immesso come VERO/FALSO in Excel, ma memorizzato come booleano in XLSX), diventa true o false nel JSON. Le date, che in Excel sono numeri seriali (il numero di giorni dal 1° gennaio 1900), vengono convertite in stringhe ISO 8601 leggibili, perché JSON non ha un tipo data nativo.

Questa preservazione dei tipi elimina un’intera classe di bug nei pipeline dati, specialmente quando il JSON viene utilizzato direttamente da API, database NoSQL o applicazioni front-end che si aspettano numeri e booleani.

Elaborazione completamente lato client

La conversione avviene interamente nel browser, senza inviare alcun dato a un server. Quando l’utente seleziona o trascina un file XLSX, il browser lo analizza localmente e scrive l'output convertito sul dispositivo. La trasformazione in JSON è fatta al volo, riga per riga, e il file risultante viene generato come Blob pronto per il download.

Questo approccio ha un vantaggio fondamentale per la privacy: qualsiasi dato sensibile (elenchi di clienti, dati finanziari, informazioni personali) non lascia mai il computer dell’utente. Non c’è bisogno di fidarsi di un server remoto, né di cancellare file temporanei dopo la conversione. Per team che lavorano con dati regolamentati (GDPR, HIPAA), questa caratteristica è spesso un requisito.

Mapping dei tipi di cella: cosa diventa cosa

Il cuore della differenza rispetto al CSV è il modo in cui ogni cella XLSX viene tradotta nel corrispondente tipo JSON. Lo strumento legge il primo foglio di lavoro di un file XLSX caricato, estrae i valori visibili e li scrive come un array di oggetti JSON. La prima riga del foglio di lavoro diventa le chiavi dell'oggetto (un'intestazione ripetuta ottiene un suffisso _2, _3); ogni riga successiva diventa un oggetto. Poiché la conversione preserva i tipi di cella originali, l'output JSON può essere utilizzato direttamente dal codice JavaScript, da un'API REST o da qualsiasi applicazione che si aspetti dati tipizzati. Non è necessario riconvertire le stringhe in numeri o eseguire un controllo di veridicità su "FALSE" – lo strumento lo fa per te.

Ecco la mappatura standard implementata dallo strumento:

Attenzione alle date: Excel non memorizza le date come stringhe, ma come numeri seriali (ad esempio 45678 corrisponde al 15 marzo 2025). Lo strumento interpreta il numero e produce una stringa ISO 8601 in UTC, come "2023-08-15T00:00:00.000Z". Se hai bisogno di un formato diverso, devi post-elaborare il JSON. Lo stesso vale per percentuali e valute – sono memorizzate come numeri nell'XLSX, quindi diventano numeri nel JSON. Un valore percentuale del 12.5% appare come 0.125, non "12.5%". Lo strumento non conserva la maschera di formato sottostante; legge solo il valore numerico memorizzato.

Celle unite: quando due o più celle sono unite orizzontalmente o verticalmente, il valore visibile è quello della cella in alto a sinistra. Le celle unite a destra o in basso appaiono come stringhe vuote nell'output JSON.

Regole e limitazioni note

La conversione presenta vincoli precisi, documentati dagli stessi messaggi di errore dell’interfaccia:

• Solo il primo foglio di lavoro viene elaborato. Se il file Excel contiene più fogli, tutti gli altri vengono ignorati. Per estrarre dati da altri fogli è necessario ripetere la conversione dopo averli spostati come primo foglio, oppure utilizzare uno strumento che supporti la selezione del foglio.
• Le formule non vengono ricalcolate. Il file XLSX contiene il valore calcolato al momento dell’ultimo salvataggio in Excel. Se il file è stato creato con una libreria che non ricalcola le formule, il valore potrebbe essere assente o errato. Non si può ottenere il risultato di formule dinamiche senza prima aprire e salvare il file in Excel.
• Formattazione e stili (grassetto, colore, bordi, dimensioni delle celle) sono completamente scartati. JSON non supporta la formattazione visiva.
• Limiti di dimensione e numero di righe/colonne. Il file non deve superare gli 8 MB. La tabella non deve superare le 10.000 righe e le 200 colonne. Se il file supera una di queste soglie, viene mostrato il messaggio “This file is too large. Use a file under ‹max›.” oppure “La conversione sta richiedendo troppo tempo. Provi con un file di dimensioni inferiori.” se la conversione impiega più di circa 12 secondi.
• File non validi. Se il XLSX non può essere aperto (corrotto, non è un vero ZIP, estensione sbagliata), appare “This Excel file could not be opened.” Se il primo foglio è vuoto, “This file has no table rows.”

Tutti i messaggi di errore sono in inglese nell’interfaccia; la tabella seguente riassume i più comuni:

Chi ha bisogno di questo strumento

Il pubblico principale è composto da sviluppatori e analisti che quotidianamente incrociano Excel e JSON.

• Uno sviluppatore web riceve un catalogo prodotti in XLSX dal team marketing. Deve importarlo in un’app React che si aspetta JSON. Con un trascinamento ottiene la struttura [{“id”: 1, “nome”: “Prodotto A”, “prezzo”: 12.50}] con i numeri già pronti per essere utilizzati senza parsing.
• Un data analyst ha un report trimestrale in XLSX che deve essere processato da uno script Python. Piuttosto che scrivere un parser per XLSX, lo converte in JSON e lo carica con json.load(). I booleani nelle colonne “Attivo” e “Completato” rimangono true/false, evitando confronti con stringhe.
• Un consulente della privacy deve condividere dati sensibili (fermo restando l’anonimizzazione) con un partner esterno che preferisce JSON. Usare un servizio cloud per la conversione sarebbe inaccettabile. Lo strumento locale garantisce che i dati non lascino mai la macchina.
• Un team agile lavora con strumenti di automazione che leggono JSON da file. Il project manager produce stime in Excel; un membro del team converte il foglio in JSON e lo inserisce in un sistema CI/CD. Nessuno installa software aggiuntivo, nessuno carica dati su un server esterno.

Domande frequenti

Perché viene convertito solo il primo foglio di lavoro?

Il tool è progettato per la semplicità d’uso: un input, un output. Leggere tutti i fogli richiederebbe una logica di selezione (dropdown o checkbox) che complica l’interfaccia. Per dati distribuiti su più fogli, la soluzione pratica è estrarre ogni foglio in un file XLSX separato e convertirli uno alla volta.

Cosa succede se la prima riga non contiene le intestazioni delle colonne?

Lo strumento assume che la prima riga del foglio contenga i nomi delle colonne, che diventano le chiavi degli oggetti JSON. Se la prima riga è un titolo generico o è vuota, le chiavi risulteranno strane o mancanti. In questi casi, conviene preparare il file Excel spostando una riga di intestazione in prima posizione.

Le celle unite generano dati mancanti nel JSON?

Sì. Il valore visibile viene preso dalla cella in alto a sinistra dell’intervallo unito; le altre celle dell’intervallo risultano vuote e nel JSON appaiono come null. Se la colonna unita è l’intestazione, le righe sotto avranno un valore per quella colonna solo nella prima riga. Per evitare sorprese, è meglio eliminare le unioni di celle prima della conversione.

Il tool accetta anche file CSV o JSON in input?

Questa pagina è specializzata nella conversione da XLSX a JSON.

Il file XLSX viene caricato su un server?

No. L’intera elaborazione avviene nel browser. Puoi verificarlo disconnettendo la rete dopo aver selezionato il file: la conversione funzionerà comunque. I dati non lasciano mai il tuo computer.

Posso convertire un file XLSX con macro o tabelle pivot?

Le macro non vengono eseguite (non c’è runtime VBA nel browser). Le tabelle pivot sono strutture derivate; il tool legge solo i dati sottostanti del foglio, non la vista della pivot. Il risultato includerà i valori grezzi (non aggregati) della tabella pivot, che spesso non è quello che si desidera. È consigliabile esportare prima i dati di origine dalla pivot.