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, verifique os registos e converta para JSON mantendo os valores como texto.
Ficheiros 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 ficheiro fácil de verificar
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 numa célula. Substituir todos os pontos e vírgulas por vírgulas alteraria esses valores. Este passo a passo usa três registos fictícios para verificar cada etapa antes de trabalhar com a sua própria exportação.
Descarregue example-semicolon.csv e abra o ficheiro num 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 registo contém uma quebra de linha real, por isso o ficheiro tem mais linhas visíveis do que registos de dados.
2. Troque o delimitador sem alterar os valores
Copie todo o conteúdo do ficheiro para o conversor de delimitador de CSV. Selecione Ponto e vírgula como delimitador de origem e execute a conversão. 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 a sua vírgula decimal. O texto Kit; taille M preserva o ponto e vírgula. Na nota do segundo registo, as aspas à volta de merci são duplicadas conforme o formato CSV, e a quebra de linha continua dentro da mesma célula.
3. Verifique os registos antes de continuar
Cole o resultado no explorador CSV e selecione Vírgula. Clique em “Explorar CSV” para mostrar a tabela. Deve ver três registos e cinco colunas. Pesquise 0042: apenas uma linha deve permanecer. Verifique o identificador e a nota. A tabela pode mostrar 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 ficheiro com expected-filtered-0042.csv. Limpe a pesquisa para voltar a ver as três linhas. O download contém apenas os registos que correspondem ao filtro. Por isso, use o resultado completo do conversor de delimitador na próxima etapa se quiser incluir os três registos 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 torna-se o nome de uma propriedade. O identificador "0007" continua a ser 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 registo vira "", e não null.
A quebra de linha aparece como a sequência de escape \n no texto JSON. Quando uma aplicação 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 da aplicação de destino.
Antes de usar a sua própria exportação
Os cabeçalhos devem ser únicos e todos os registos têm de ter o mesmo número de campos. Aspas mal posicionadas são rejeitadas. O explorador aceita até 2.000.000 de caracteres e mostra os primeiros 500 registos que correspondem à pesquisa; a exportação inclui todos os registos 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 numa folha de cálculo, 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 verifique as colunas de texto. O comportamento varia entre aplicações de folha de cálculo; 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.
Porque é que a minha folha de cálculo removeu os zeros à esquerda?
A aplicação pode interpretar uma coluna como números. Verifique o ficheiro de texto e escolha importar os identificadores como texto. Depois, verifique o resultado no a sua aplicação.
Posso converter apenas o registo 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.