De CSV com ponto e vírgula para JSON, preservando os zeros à esquerda
Acompanhe um CSV fictício com aspas e uma célula de várias linhas: troque o delimitador, confira os registros e converta para JSON mantendo os valores como texto.
Arquivos fictícios para reproduzir as etapas
- CSV de origem com ponto e vírgula (example-semicolon.csv)
- CSV esperado separado por vírgulas (expected-comma.csv)
- JSON esperado (expected.json)
- CSV filtrado por 0042 (expected-filtered-0042.csv)
Exemplo de origem
id;name;note;amount;active 0007;Atelier Demo;"Kit; taille M";12,50;false 0042;Studio Exemple;"Message ""merci"" Livraison mardi";0;true 0105;Boutique Fictive;"Paris, France";;false
1. Comece com um arquivo fácil de conferir
Uma exportação separada por ponto e vírgula pode conter outro ponto e vírgula dentro de uma descrição, aspas e até uma quebra de linha em uma célula. Substituir todos os pontos e vírgulas por vírgulas alteraria esses valores. Este passo a passo usa três registros fictícios para você conferir cada etapa antes de trabalhar com sua própria exportação.
Baixe example-semicolon.csv e abra o arquivo em um editor de texto. As cinco colunas são id, name, note, amount e active. Os identificadores são 0007, 0042 e 0105. A nota do segundo registro contém uma quebra de linha real, por isso o arquivo tem mais linhas visíveis do que registros de dados.
2. Troque o delimitador sem alterar os valores
Copie todo o conteúdo do arquivo para o conversor de delimitador de CSV. Selecione Ponto e vírgula como delimitador de origem e execute a conversão. Você precisa escolher o delimitador manualmente; a saída sempre usa vírgulas entre as colunas. Copie o resultado e compare com expected-comma.csv.
O valor 12,50 passa a ser um campo entre aspas na saída separada por vírgulas, mas mantém sua vírgula decimal. O texto Kit; taille M preserva o ponto e vírgula. Na nota do segundo registro, as aspas ao redor de merci são duplicadas conforme o formato CSV, e a quebra de linha continua dentro da mesma célula.
3. Confira os registros antes de continuar
Cole o resultado no explorador CSV e selecione Vírgula. Clique em “Explorar CSV” para exibir a tabela. Você deve ver três registros e cinco colunas. Pesquise 0042: apenas uma linha deve permanecer. Confira o identificador e a nota. A tabela pode exibir a quebra de linha da célula como um espaço; a exportação filtrada permite verificar se ela foi preservada no valor.
Selecione “Exportar CSV filtrado” e use o link de download gerado. Compare esse arquivo com expected-filtered-0042.csv. Limpe a pesquisa para voltar a ver as três linhas. O download contém apenas os registros que correspondem ao filtro. Por isso, use o resultado completo do conversor de delimitador na próxima etapa se quiser incluir os três registros no JSON.
4. Converta para JSON com valores de texto
Cole o resultado completo separado por vírgulas em Converter CSV em JSON. Compare a saída com expected.json: deve haver três objetos. Cada cabeçalho se torna o nome de uma propriedade. O identificador "0007" continua sendo uma string, ou cadeia de texto, com seus zeros à esquerda; "false", "true", "0" e "12,50" também permanecem strings. A célula vazia de amount no terceiro registro vira "", e não null.
A quebra de linha aparece como a sequência de escape \n no texto JSON. Quando um aplicativo lê esse JSON, a sequência representa uma quebra de linha dentro do valor. A conversão não interpreta os valores como números, datas ou booleanos. Se precisar converter os tipos depois, faça isso de forma deliberada, de acordo com os requisitos do aplicativo de destino.
Antes de usar sua própria exportação
Os cabeçalhos devem ser únicos e todos os registros precisam ter o mesmo número de campos. Aspas mal posicionadas são rejeitadas. O explorador aceita até 2.000.000 de caracteres e exibe os primeiros 500 registros que correspondem à pesquisa; a exportação inclui todos os registros filtrados. Esses limites não garantem o mesmo desempenho em todos os dispositivos.
A conversão não neutraliza fórmulas. Antes de abrir dados de origem não confiável em uma planilha, examine as células que começam com =, +, -, @, uma tabulação ou uma quebra de linha. As aspas do formato CSV, por si só, não tornam esses dados seguros. Use as opções de importação adequadas e confira as colunas de texto. O comportamento varia entre aplicativos de planilha; este passo a passo não garante compatibilidade universal com o Excel.
Perguntas frequentes
O conversor de delimitador pode gerar um CSV separado por ponto e vírgula?
Não. Ele lê dados separados por vírgulas, pontos e vírgulas ou tabulações e gera um CSV separado por vírgulas.
Por que minha planilha removeu os zeros à esquerda?
O aplicativo pode interpretar uma coluna como números. Confira o arquivo de texto e escolha importar os identificadores como texto. Depois, verifique o resultado no seu aplicativo.
Posso converter apenas o registro pesquisado para JSON?
Sim. Exporte o CSV filtrado no explorador com Vírgula selecionado e cole o conteúdo em Converter CSV em JSON. Neste exemplo, a pesquisa por 0042 produz um único objeto.