Les règles du CSV
Un fichier CSV (valeurs séparées par des virgules) range un tableau dans du texte brut : une ligne par enregistrement, un séparateur entre les cellules. Il n'existe pas de norme unique, mais la RFC 4180 de l'IETF décrit les règles que suivent la plupart des logiciels, et que cet outil applique :
- chaque enregistrement tient sur une ligne, terminée par un saut de ligne ;
- une cellule qui contient le séparateur, un guillemet ou un saut de ligne s'écrit entre guillemets doubles ;
- à l'intérieur de ces guillemets, un guillemet s'écrit doublé :
""; - la première ligne peut donner le nom des colonnes.
Lyon"Lyon, Rhône""dit ""Gones"""Côté JSON, l'outil produit un tableau d'objets : un objet par ligne, une clé par colonne. Sans ligne d'en-têtes, il produit un tableau de tableaux. Une colonne sans nom devient colonne_1,colonne_2… et un nom en double reçoit un suffixe (prix_2), car un objet JSON ne devrait pas avoir deux fois la même clé.
Virgule, point-virgule ou tabulation ?
En français, la virgule sert de séparateur décimal. Les tableurs réglés en français enregistrent donc leurs CSV avec un point-virgule entre les colonnes, pour que 1,20 reste un seul nombre. Les exports copiés depuis un tableau sont souvent séparés par des tabulations.
En mode « Détection auto », l'outil essaie les trois séparateurs sur les premières lignes et garde celui qui donne le même nombre de colonnes partout, au moins deux. C'est une estimation : si le résultat vous paraît faux, imposez le séparateur.
Trois exemples
produit;prix puis Pain;1,20 et Café;2,50 : point-virgule détecté, 2 objets {"produit": "Pain", "prix": 1.2} et {"produit": "Café", "prix": 2.5}. Le JSON écrit les décimales avec un point.
titre,auteur puis "Bonjour, monde","Il dit ""oui""" donne 1 objet : "titre": "Bonjour, monde" et "auteur": "Il dit \"oui\"". La virgule entre guillemets ne coupe pas la cellule.
a,b,c puis 1,2 : la cellule manquante devient une chaîne vide, ou null avec l'option des types, soit {"a": 1, "b": 2, "c": null}.
Du JSON au CSV
Dans l'autre sens, collez un tableau d'objets. Les colonnes sont toutes les clés rencontrées, dans leur ordre d'apparition : un objet auquel il manque une clé laisse sa cellule vide. Un objet ou un tableau imbriqué est écrit en JSON dans sa cellule. Les lignes sont séparées par un retour chariot suivi d'un saut de ligne (CRLF), comme le prévoit la RFC 4180. Avec le point-virgule, [{"a": 1}, {"a": 2, "b": "x;y"}] donne a;b, 1; et 2;"x;y".
Le piège des zéros en tête
Un code postal, un numéro de téléphone ou une référence commencent parfois par zéro. Les lire comme des nombres efface ce zéro : 01000, le code postal de Bourg-en-Bresse, deviendrait 1000. Même avec l'option des types, l'outil laisse donc en texte tout nombre qui commence par un zéro suivi d'un chiffre, ainsi que les entiers trop grands pour être gardés exactement.
Questions fréquentes
Comment convertir un fichier Excel en JSON ?
Enregistrez la feuille au format CSV depuis le tableur, ouvrez le fichier avec un éditeur de texte, puis collez son contenu dans le champ. Le point-virgule qu'utilisent les tableurs réglés en français est détecté automatiquement.
Pourquoi mon CSV utilise-t-il des points-virgules ?
Parce qu'en français la virgule sert de séparateur décimal (1,20 €). Les tableurs réglés en français séparent donc les colonnes par un point-virgule, pour ne pas couper les nombres en deux.
Comment écrire une virgule ou un guillemet dans une cellule CSV ?
Mettez la cellule entre guillemets doubles : "Paris, France". Un guillemet à l'intérieur s'écrit doublé : "Il dit ""oui""". Une cellule entre guillemets peut aussi contenir des retours à la ligne.
Les nombres du CSV deviennent-ils des nombres en JSON ?
Seulement si vous cochez l'option des types. Sans elle, chaque cellule reste du texte, ce qui ne perd jamais rien. Avec elle, 12 et 1.5 deviennent des nombres (1,5 aussi, si le séparateur n'est pas la virgule), true et false des booléens, une cellule vide null, mais 01000 reste du texte.
Mes données sont-elles envoyées sur un serveur ?
Non. La conversion se fait dans votre navigateur ; les données ne sont ni envoyées ni gardées dans l'adresse de la page, où ne figurent que les réglages.
Une erreur ? Signalez-la, nous la corrigeons.