Ir para o conteúdo principal
Bethemesh
Dados e folhas de cálculo

Converter CSV em JSON (e JSON em CSV)

Passe facilmente de uma tabela CSV para uma estrutura JSON, ou vice-versa, e obtenha o resultado pronto para copiar ou transferir.

  • Área de transferência

Integrar este widget

Personalize o resultado, verifique a pré-visualização e copie o código.

Pré-visualização

Tipo de código de integração

Código a copiar

Responsivo e redimensionado automaticamente pela Bethemesh.

Esta ferramenta foi útil?

Como funciona esta ferramenta?

CSV descreve linhas e colunas, enquanto JSON pode representar objetos, listas e vários tipos de valor. Este conversor liga uma tabela CSV com cabeçalho a uma lista JSON de objetos planos. Serve para preparar um exemplo de API, recuperar uma exportação aplicacional ou mover dados entre uma folha de cálculo e um script. Os dois sentidos não garantem um percurso de ida e volta idêntico: CSV não distingue naturalmente null, um campo ausente e uma cadeia vazia, nem um número do texto que se lhe parece. Essas diferenças exigem um esquema explícito.

Escolha expressamente vírgula, ponto e vírgula ou tabulação. O ajuste serve para ler CSV num sentido e escrevê-lo no outro; esta interface não oferece deteção automática nem barra vertical. CSV para JSON trata sempre o primeiro registo lógico como cabeçalho e produz um objeto por linha seguinte. Retiram-se os espaços exteriores dos títulos. Nomes vazios ou repetidos recebem substitutos para preservar todas as colunas. Campos adicionais de uma linha longa também obtêm propriedades, evitando perdas por colisão de nomes.

Cada valor lido do CSV continua a ser uma cadeia JSON. Um montante 12,50 não é interpretado como número e a referência 001 conserva os zeros iniciais. Os campos citados podem conter separadores, aspas duplicadas ou várias linhas. Uma aspa por fechar bloqueia a operação. Em JSON para CSV, a entrada deve ser uma lista não vazia de objetos com células de texto, números finitos, booleanos ou null. Um objeto isolado, uma lista numérica ou uma célula aninhada não constituem uma tabela plana aceite.

As propriedades presentes nos objetos formam o conjunto das colunas exportadas. Uma propriedade ausente ou null torna-se uma célula vazia; os booleanos passam a texto true ou false e os números usam a representação textual JavaScript. Objetos e listas aninhados são recusados em vez de se tornarem texto inútil. Aplane-os antes se precisar de colunas com caminhos explícitos. A saída JSON tem indentação e o CSV recebe aspas conforme o separador. A importação limita os ficheiros a 5 MiB e lê UTF-8. Não se preservam estilos ou metadados de livros de cálculo.

Como usar esta ferramenta

  1. Escolha o sentido e verifique a forma da entrada

    Para CSV para JSON, forneça um cabeçalho real. Para JSON para CSV, prepare uma lista de objetos planos, e não toda a estrutura de uma resposta de API com resultados guardados noutra propriedade.

  2. Defina separador e tipos esperados

    Escolha o delimitador real do CSV ou o exigido na saída. Verifique a pontuação JSON: aspas duplas nos nomes, vírgulas entre elementos e ponto nos números decimais, mesmo quando o conteúdo está em português.

  3. Examine valores potencialmente ambíguos

    Execute a conversão e reveja propriedades geradas, identificadores, valores nulos e números. Copie ou exporte o formato escolhido e teste o resultado na aplicação destinatária antes de uma importação importante dos dados.

Casos de uso

Preparar dados tabulares para uma API

Converta uma pequena exportação CSV numa lista de objetos para um script ou teste de API e confira depois os tipos exigidos, sem assumir que se efetuou uma conversão numérica automática durante a serialização.

Abrir uma exportação JSON plana em colunas

Produza CSV a partir de objetos simples para uma aplicação tabular. Propriedades ausentes nalguns registos transformam-se em células vazias, mantendo o alinhamento com o conjunto de colunas encontrado.

Preservar referências com zeros iniciais

Leia referências CSV como cadeias JSON para manter a escrita original. O conversor não precisa de adivinhar quais as sequências de algarismos que identificam entidades e quais representam montantes ou outras quantidades calculáveis.

Exemplos

Manter o preço como texto JSON

CSV para JSON com ponto e vírgula mantém 001 e 002 como cadeias, tal como os preços com vírgula decimal. O resultado não fornece montantes já numéricos para cálculos: o programa consumidor deve escolher expressamente a conversão apropriada.

Entrada

id;preco
001;12,50
002;8,00

Resultado

[
  {
    "id": "001",
    "preco": "12,50"
  },
  {
    "id": "002",
    "preco": "8,00"
  }
]

Exportar números, booleanos e ausências

JSON para CSV com ponto e vírgula escreve 12.5 e true para A. O montante null de B fica vazio, tal como a propriedade ativo ausente. Uma conversão inversa não recuperaria a distinção entre essas duas formas de representar ausência.

Entrada

[{"id":"A","montante":12.5,"ativo":true},{"id":"B","montante":null}]

Resultado

id;montante;ativo
A;12.5;true
B;;

Dicas e boas práticas

  • Para conservar sem arredondamento um identificador JSON grande, forneça-o como cadeia entre aspas. Os números são lidos com precisão JavaScript, não por uma representação de inteiros arbitrariamente grandes que preserve garantidamente todos os algarismos.
  • Evite propriedades repetidas no mesmo objeto JSON: o leitor conserva o último valor antes da conversão. É diferente dos cabeçalhos CSV duplicados, que podem ser renomeados preservando todas as colunas físicas de origem.
  • Não substitua globalmente vírgulas por pontos para converter montantes: também alteraria separadores JSON ou CSV. Aplique uma conversão de tipo direcionada apenas às colunas que devam realmente representar quantidades numéricas.

Fontes e referências

Perguntas frequentes

Porque aparecem os números CSV entre aspas em JSON?

CSV não fornece tipos fiáveis para as células. Preservar cadeias protege referências com zeros iniciais e outras escritas intencionais. O esquema da aplicação deve decidir quais as colunas que se tornam números, sem delegar essa escolha ao delimitador.

Posso converter diretamente um objeto JSON aninhado?

Não. JSON para CSV exige aqui uma lista de objetos planos. Aplane os caminhos aninhados ou extraia primeiro a propriedade que contém os registos. Objetos não são substituídos silenciosamente por [object Object] quando não são células escalares válidas.

O que acontece a null no CSV produzido?

Torna-se uma célula vazia, como uma propriedade ausente ou uma cadeia vazia. Esta conversão não mantém essa distinção de tipo em CSV. Se for essencial, codifique uma convenção explícita antes de exportar e documente-a para o destinatário.

Um percurso CSV e JSON conserva todos os tipos?

Não. Os valores lidos de CSV regressam como cadeias. Números, booleanos e ausências exportados em CSV não recuperam automaticamente os tipos originais. Os títulos também podem ser normalizados para evitar colisões entre propriedades dos objetos.

Fluxo de trabalho recomendado

Continue o processamento

Descubra ferramentas que se integram naturalmente antes, depois ou em conjunto com esta.

Funciona bem com

Converter Excel, CSV e JSON

Converta facilmente ficheiros Excel, CSV e outros formatos de tabelas diretamente no navegador.

Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta

Formatador JSON

Formate, minifique e valide um documento JSON para o tornar mais legível ou compacto.

Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta

Usar antes

Próximo passo

Formatador JSON

Formate, minifique e valide um documento JSON para o tornar mais legível ou compacto.

Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta

Leia também