Come si usa
- Incolla un array JSON di oggetti, apri un file .json oppure premi «Prova un esempio».
- Scegli il delimitatore previsto dal tuo foglio di calcolo e come scrivere gli array all'interno degli oggetti.
- Controlla l'anteprima del CSV. Ogni oggetto corrisponde a una riga; i campi annidati diventano colonne, ad esempio address.city.
- Copia il CSV o scaricalo come file .csv.
Come funziona
Ogni elemento dell'array di primo livello diventa una riga. Le colonne comprendono tutte le chiavi, nell'ordine in cui compaiono per la prima volta, così gli oggetti con campi diversi restano allineati; un campo mancante o con valore null genera una cella vuota. Gli oggetti annidati vengono appiattiti usando percorsi separati da punti: {"address": {"city": "Oslo"}} diventa una colonna chiamata address.city. Se la radice è un singolo oggetto, il risultato è una riga. Gli array di valori semplici (come [1, 2, 3]) generano una sola colonna chiamata value.
Gli array all'interno degli oggetti possono essere scritti in tre modi: come testo JSON in una cella (["a","b"]), uniti in un'unica cella (a; b) oppure distribuiti su colonne numerate (tags.0, tags.1). Scegli l'ultima opzione quando ogni riga contiene un elenco simile e breve.
Il risultato segue RFC 4180: un campo viene racchiuso tra virgolette doppie se contiene il delimitatore, una virgoletta doppia o un'interruzione di riga, e le virgolette al suo interno vengono raddoppiate. Le righe terminano con interruzioni di riga CRLF. In molte impostazioni locali europee, Excel si aspetta punti e virgola invece delle virgole, perché la virgola è il separatore decimale. Inoltre, quando apre un file CSV, Excel potrebbe riformattare i numeri lunghi, gli zeri iniziali e il testo che sembra una data; se i valori devono restare esatti, importa il file come testo. I numeri superiori a 2^53 perdono precisione durante l'analisi del JSON.
Esempi
Esportare utenti da un'API
Un'API restituisce [{"id":1,"name":"Ada","address":{"city":"London"}}, …]. Il CSV contiene le colonne id, name e address.city, pronte per essere ordinate e filtrate in un foglio di calcolo.
Testo con virgole e virgolette
Un nome come Alan "AT" Turing diventa "Alan ""AT"" Turing" e una città come Wilmslow, Cheshire viene racchiusa tra virgolette, così i programmi per fogli di calcolo mantengono ogni valore nella propria cella.
Aprire il file con Excel in tedesco o francese
Scegli Punto e virgola come delimitatore e attiva il BOM UTF-8. Excel separerà correttamente le colonne e visualizzerà caratteri come ä ed é senza alterazioni.
Domande frequenti
Cosa succede con un JSON annidato a più livelli?
Gli oggetti annidati vengono appiattiti a ogni livello e trasformati in nomi di colonna con percorsi separati da punti, ad esempio order.customer.address.zip. Gli array vengono convertiti secondo l'opzione scelta: testo JSON, valori uniti o una colonna per elemento.
Perché alcune celle sono vuote?
Una cella è vuota se l'oggetto non contiene la chiave oppure se il suo valore è null. Le colonne vengono ricavate da tutti gli oggetti insieme, quindi anche una chiave presente solo in alcuni oggetti avrà una colonna.
Quale delimitatore devo usare?
La virgola è lo standard. Usa il punto e virgola per Excel nelle impostazioni locali che usano la virgola per i decimali (gran parte dell'Europa e dell'America Latina) e la tabulazione se i dati contengono molte virgole o se vuoi incollarli direttamente in un foglio di calcolo.
È possibile riconvertire il CSV in JSON?
Sì, con il convertitore da CSV a JSON disponibile su questo sito. Tieni presente che l'appiattimento non è del tutto reversibile: i nomi di colonna con percorsi separati da punti tornano come semplici chiavi, ad esempio "address.city", e non come oggetti annidati.
Privacy
La conversione avviene nel browser. Il JSON e il CSV risultante non vengono caricati, archiviati né inclusi nelle statistiche.