O que esta página faz
Esta página recebe um ficheiro Excel no formato XLSX e devolve um ficheiro JSON que representa os dados da primeira folha de cálculo como uma tabela estruturada. Todo o processamento ocorre no navegador — nenhum dado é enviado para qualquer servidor. O utilizador pode arrastar o ficheiro ou escolhê-lo através do seletor de ficheiros. O resultado é apresentado como pré-visualização e fica disponível para descarga.
A conversão de XLSX para JSON não é equivalente a uma conversão para CSV. O formato XLSX é um arquivo ZIP que contém múltiplos ficheiros XML, descrevendo as pastas de trabalho, as folhas, os tipos de célula (texto, número, data, booleano), fórmulas e formatação rica. O JSON, por sua vez, é um formato tipado e aninhável que suporta objetos, vetores, números, booleanos e nulo. Quando se converte de XLSX para JSON, os valores numéricos e booleanos podem ser preservados como valores tipados no JSON, em vez de serem forçados a cadeias de caracteres entre aspas. A formatação das células, as fórmulas (que não são recalculadas) e quaisquer dados para além da primeira folha são descartados. Ao contrário do CSV, que achata cada linha numa linha de texto simples, o JSON representa a estrutura tabular como um vetor de objetos, mantendo os nomes das colunas como chaves.
O que a distingue de outras conversões
A principal diferença reside na preservação dos tipos de dados. Numa conversão para CSV, todos os valores são transformados em texto: um número como 1234 torna-se a string "1234", um booleano VERDADEIRO torna-se a string "VERDADEIRO". Nesta página, os valores numéricos são convertidos para números JSON (como 1234), os booleanos para true ou false, e as células vazias para "" (string vazia). Isto é essencial para quem precisa de consumir os dados numa API ou numa aplicação JavaScript que espera tipos nativos, sem ter de fazer parsing adicional.
Outra caraterística importante é o processamento local. O ficheiro XLSX é lido diretamente no navegador, sem qualquer envio para um servidor externo. Isto garante privacidade: dados sensíveis contidos no ficheiro nunca abandonam o computador do utilizador. Para organizações com políticas rigorosas de proteção de dados, esta página oferece uma solução segura para conversões pontuais.
O entendimento do que acontece durante a conversão exige conhecer a estrutura interna de um ficheiro XLSX. Cada ficheiro XLSX é um arquivo ZIP que contém, entre outros, os ficheiros xl/workbook.xml (que define as folhas), xl/worksheets/sheet1.xml (os dados da primeira folha), xl/sharedStrings.xml (as strings partilhadas) e xl/styles.xml (formatação). O conversor lê a primeira folha, extrai as linhas e colunas, e mapeia cada célula para o tipo adequado. As fórmulas não são calculadas: apenas o valor previamente guardado (o "valor da célula" após a última gravação) é utilizado. Portanto, se uma célula contém a fórmula =A1+B1, mas o ficheiro foi guardado com valores estáticos, é esse valor estático que será convertido — a fórmula em si é ignorada.
Como funciona a conversão: entrada e saída
Entrada: um único ficheiro XLSX, arrastado para a área de destino ou selecionado através do botão de escolha. O ficheiro deve ter uma extensão .xlsx; ficheiros XLS (antigo formato binário) não são suportados.
Saída: um ficheiro JSON que contém a representação dos dados da primeira folha. A pré-visualização mostra o conteúdo em formato legível (as primeiras 8 linhas e 8 colunas), com um contador de linhas e colunas. O tamanho do ficheiro JSON de saída é indicado, permitindo avaliar se o resultado é adequado para o uso pretendido.
O JSON gerado segue a estrutura de um vetor de objetos. Cada objeto corresponde a uma linha da tabela, e as chaves são os nomes das colunas (primeira linha da folha). Exemplo:
[
{
"Nome": "Ana Silva",
"Idade": 34,
"Ativo": true
},
{
"Nome": "João Pereira",
"Idade": null,
"Ativo": false
}
]
Caso a primeira linha não contenha cabeçalhos (por exemplo, se a tabela começar diretamente com dados), o conversor usa chaves genéricas como coluna0, coluna1, etc.
Regras e limitações importantes
A página lê apenas a primeira folha do ficheiro XLSX. Se o ficheiro tiver múltiplas folhas, as restantes são ignoradas. Para converter dados de outras folhas, é necessário extraí-las separadamente (por exemplo, guardando cada folha como um ficheiro XLSX individual).
As fórmulas não são recalculadas. O valor convertido é o valor visível que foi guardado no ficheiro. Se a fórmula depende de cálculos que não foram atualizados, o resultado pode não corresponder ao esperado.
Toda a formatação visual — fontes, cores, bordas, células fundidas — é descartada. Apenas os valores das células são preservados. Células fundidas mantêm apenas o valor superior esquerdo; as restantes células fundidas tornam-se strings vazias.
Se o ficheiro XLSX não puder ser analisado, é exibida a mensagem de erro "Não foi possível abrir este ficheiro do Excel.". Se a primeira folha não contiver linhas de dados, aparece "Este ficheiro não possui linhas de tabela.".
Existem limites de tamanho de ficheiro, número de linhas e número de colunas. O ficheiro tem um limite de 8 MB, 10.000 linhas e 200 colunas. Se o ficheiro exceder o limite de 8 MB, a mensagem "Este ficheiro é grande demais. Use um ficheiro com menos de {max}." é mostrada.
Outros erros possíveis incluem: "Escolha um ficheiro CSV, JSON ou XLSX." (caso o ficheiro selecionado não seja um desses formatos), "Não foi possível converter este ficheiro." (falha genérica), "Conversão cancelada." (se o utilizador interromper o processo) e "Esta conversão está a demorar muito tempo. Tente um ficheiro menor." (para ficheiros muito grandes ou com muitas células, ou se a conversão demorar mais de 12 segundos).
Quem precisa desta ferramenta
- Desenvolvedores web que recebem dados de produtos num ficheiro Excel e precisam de os integrar numa API ou numa aplicação front-end que consome JSON.
- Analistas de dados que transformam rapidamente um relatório trimestral (XLSX) num formato legível por máquina para processamento adicional, como alimentar um script Python ou uma base de dados NoSQL.
- Equipas que colaboram com parceiros externos que preferem JSON em vez de Excel, e necessitam de uma conversão pontual sem instalar software adicional.
- Utilizadores preocupados com a privacidade que pretendem converter ficheiros XLSX para JSON sem os carregar para um serviço na nuvem, assegurando que os dados permanecem no próprio computador.
Perguntas frequentes
Como são tratadas as datas?
As células com formato de data no Excel são convertidas para strings ISO 8601 em UTC, como "2023-08-15T00:00:00.000Z". O formato original do Excel é descartado. Se precisar de um formato de data específico, deve pós-processar a string ISO.
Posso converter várias folhas de uma só vez?
Não. A página lê apenas a primeira folha. Se precisar de dados de outras folhas, deve primeiro mover essa folha para a primeira posição no Excel antes de carregar, ou usar uma ferramenta que suporte a seleção de folhas.
O que acontece se o ficheiro tiver fórmulas?
A fórmula em si não é convertida. Apenas o valor visível (que foi guardado no ficheiro) é utilizado. Se precisar de calcular as fórmulas, deve abrir o ficheiro no Excel e guardá-lo novamente para atualizar os valores.
A conversão funciona com ficheiros XLS antigos?
Não. Apenas ficheiros no formato XLSX (introduzido no Office 2007) são suportados. Ficheiros XLS (binários) não podem ser lidos por este conversor. Deve converter o XLS para XLSX primeiro, por exemplo, abrindo-o no Excel e guardando como "Pasta de Trabalho do Excel (*.xlsx)".
Como sei se o meu ficheiro tem mais de ‹max› linhas?
O limite é verificado antes da conversão. Se exceder o limite, a página mostra a mensagem de erro apropriada. O limite é de 10.000 linhas e 200 colunas.
A página guarda os meus ficheiros?
Não. Todo o processamento é feito no navegador. Nenhum dado é enviado para servidores. O ficheiro original e o JSON convertido permanecem apenas na memória do navegador durante a sessão, e são descartados quando fecha a página ou o separador.