O que a ferramenta faz e como ela é diferente
Essa página recebe um arquivo Excel no formato XLSX e devolve um arquivo JSON contendo os dados da primeira planilha como uma tabela estruturada. Toda a conversão acontece inteiramente no navegador — nenhum arquivo é enviado para nenhum servidor. O diferencial do XLSX para JSON, em comparação com a conversão para CSV, está na preservação dos tipos de dados. Um arquivo XLSX é, na verdade, um pacote ZIP com diversos arquivos XML que armazenam múltiplas planilhas, tipos de célula (texto, número, data, booleano), fórmulas e formatação rica. JSON, por sua vez, é um formato digitado e aninhável: suporta objetos, arrays, números, booleanos e nulo. Quando você converte de XLSX para JSON, valores numéricos e booleanos podem ser mantidos como valores JSON tipados (em vez de serem forçados a strings entre aspas). Formatação de célula, fórmulas (que não são calculadas) e quaisquer dados além da primeira planilha são descartados. Diferentemente do CSV, que achata cada linha em uma linha de texto simples, o JSON pode representar a estrutura tabular como um array de objetos, mantendo os nomes das colunas como chaves. Contudo, a tabela fonte é plana — não existe hierarquia em uma tabela XLSX propriamente dita —, portanto estruturas JSON aninhadas não são criadas automaticamente.
Como funciona a conversão de XLSX para JSON
O processo começa quando você arrasta um arquivo XLSX para a área indicada ou usa o seletor de arquivos. O navegador lê o conteúdo do arquivo localmente, sem qualquer comunicação com a internet. Internamente, a ferramenta descompacta o XLSX (que é um arquivo ZIP) e percorre a estrutura XML da primeira planilha. Ela extrai as células visíveis — ou seja, o resultado que estava salvo no momento em que o arquivo foi criado. Em seguida, monta um array de objetos JSON, onde cada objeto representa uma linha da planilha e as chaves são os cabeçalhos da primeira linha (se houver). Caso a primeira linha não contenha cabeçalhos, a ferramenta gera chaves genéricas como Column1, Column2, etc..
O usuário vê imediatamente uma prévia do JSON gerado (as primeiras 8 linhas e 8 colunas), além de informações como número de linhas, colunas e o tamanho do arquivo de saída. Um botão de download permite salvar o arquivo .json no computador. Todo o processamento é síncrono e rápido para arquivos de até alguns megabytes, mas limites máximos de tamanho e quantidade de linhas/colunas são aplicados para garantir que a conversão não trave o navegador.
Mapeamento de tipos de célula: números, booleanos e datas
A grande vantagem do JSON sobre o CSV é a tipagem nativa. Ao converter um XLSX, a ferramenta examina o tipo de cada célula no arquivo XML original:
- Números (inteiros ou decimais) viram números JSON (
123,3.14), sem aspas. - Booleanos (
VERDADEIRO/FALSOouTRUE/FALSE) viram os valorestrueoufalseem JSON. - Textos (incluindo strings que parecem números, mas estão formatadas como texto) viram strings JSON entre aspas.
- Datas são um caso especial. O Excel armazena datas como números de série (dias desde 1º de janeiro de 1900) com formatação de data. A ferramenta as converte em strings ISO 8601 (ex.:
"2023-08-15T00:00:00.000Z"). - Células vazias viram strings vazias
""em JSON. - Valores de erro (como
#DIV/0!) são convertidos como strings.
Esse mapeamento evita o problema clássico do CSV, onde 123 vira "123" e true vira "TRUE", forçando o consumidor do JSON a fazer parsing adicional.
Limitações importantes: fórmulas, formatação e múltiplas planilhas
A conversão de XLSX para JSON não calcula fórmulas. O que a ferramenta lê é o valor armazenado na célula — aquele que estava visível na última vez que o arquivo foi salvo no Excel. Se a planilha contém =SOMA(A1:A10), o JSON conterá o resultado numérico que estava presente quando o arquivo foi gerado, e não a expressão da fórmula. Isso significa que, se você alterar dados de entrada e salvar novamente, precisará reenviar o arquivo para obter os novos resultados.
A formatação (fontes, cores, bordas, preenchimento) é totalmente descartada. Células mescladas também não são tratadas de forma especial; apenas o valor da célula superior esquerda é mantido, e as demais células mescladas se tornam strings vazias. O ideal é desfazer mesclas antes de converter.
A ferramenta lê apenas a primeira planilha do arquivo XLSX. Se você precisa de dados de outras abas, deve extraí-las individualmente (copiando para novas planilhas) antes de usar esta página. Não há suporte para selecionar qual planilha usar, pois o foco é simplicidade para casos mais comuns.
Regras de validação e mensagens de erro
A página impõe limites e validações para garantir que a conversão seja confiável e não sobrecarregue o navegador. As mensagens de erro são claras:
- “This Excel file could not be opened.” – O arquivo XLSX está corrompido, não é um ZIP válido ou tem estrutura XML inesperada.
- “This file has no table rows.” – A primeira planilha está completamente vazia.
- “This file is too large. Use a file under ‹max›.” – O tamanho do arquivo excede o limite máximo de 8 MB.
- “This conversion is taking too long. Try a smaller file.” – A conversão excedeu o tempo limite de aproximadamente 12 segundos.
- “Choose a CSV, JSON or XLSX file.” – O formato do arquivo enviado não é suportado.
- “Could not convert this file.” – Erro genérico de conversão, geralmente por dados inesperados.
- “Conversion cancelled.” – O usuário interrompeu o processo (por exemplo, fechando a página ou clicando em cancelar).
Todas essas validações são executadas no lado do cliente, sem chamadas de rede, o que aumenta a privacidade e a velocidade.
Quem precisa dessa conversão e por quê
Desenvolvedores web que recebem dados de produtos em planilhas Excel e precisam inseri-los em uma API ou aplicação front-end encontram nessa ferramenta um atalho direto. Em vez de escrever um script próprio para ler XLSX, eles podem simplesmente arrastar o arquivo e baixar o JSON pronto.
Analistas de dados que transformam relatórios trimestrais em JSON para processamento em pipelines automatizados (como serviços de big data ou bancos NoSQL) também se beneficiam. A conversão preserva tipos numéricos, o que evita erros de schema ao importar para bancos como MongoDB ou PostgreSQL via JSON.
Equipes que colaboram com parceiros externos que preferem JSON ao Excel têm uma solução sem instalação de software. Basta abrir a página no navegador, converter e enviar o arquivo. A ausência de upload para servidores é um diferencial para quem lida com dados sensíveis (como informações financeiras ou pessoais). O processamento local garante que o arquivo nunca saia do computador do usuário.
Perguntas frequentes (FAQ)
1. Por que as datas aparecem como números no JSON?
As datas são convertidas para strings ISO 8601 (ex.: "2023-08-15T00:00:00.000Z"). O formato original do Excel é descartado. Se você precisa de um formato de data específico, deve pós-processar a string ISO.
2. Posso converter um arquivo com várias planilhas?
Não. A página lê apenas a primeira planilha. Para converter outras abas, você deve primeiro mover essa planilha para a primeira posição no Excel antes de fazer o upload, ou usar uma ferramenta que suporte a seleção de planilhas.
3. O que acontece com células mescladas?
Apenas a célula superior esquerda de uma região mesclada retém seu valor. Todas as outras células na região se tornam strings vazias no JSON de saída. Isso pode criar lacunas em seus objetos de linha. É melhor desfazer as mesclagens e preencher os valores antes de converter.
4. O arquivo é enviado para algum servidor?
Não. Todo o processamento ocorre no seu navegador. O arquivo permanece apenas no seu computador. Isso garante privacidade total dos dados.
5. Qual é o limite de tamanho do arquivo?
Sim. Os arquivos são limitados a 8 MB, e as tabelas a 10.000 linhas e 200 colunas. Se qualquer limite for excedido, a conversão é interrompida com uma mensagem de erro clara.
6. Posso converter um arquivo XLS (antigo) em vez de XLSX?
Não. A ferramenta aceita apenas o formato XLSX (aberto baseado em XML). Para arquivos XLS (binários do Excel 97-2003), é necessário primeiro convertê-los para XLSX no Excel ou em outro programa.