Внутреннее устройство XLSX и почему JSON — не просто другой CSV
Когда вы загружаете файл Excel (XLSX) на этой странице, браузер распаковывает zip-архив, читает XML-файлы внутри него и извлекает данные только из первого листа. Полученная таблица преобразуется в JSON: массив объектов, где ключи — названия столбцов из первой строки, а значения — соответствующие ячейки. Всё это происходит локально, без отправки данных на сервер.
Основное отличие этого преобразования от конвертации XLSX в CSV — сохранение типов. CSV — это плоский текст: все числа, даты, булевы значения становятся строками. JSON, напротив, поддерживает числа (integer, float), логические (true/false), null и строки. Поэтому числовые ячейки Excel (например, 123.45) превратятся в число в JSON, а не в строку "123.45". Это критично для API, которые ожидают числовые поля, или для последующей обработки в JavaScript.
При этом XLSX-файл — это не просто таблица. Это набор сжатых XML-документов, описывающих листы, стили, формулы, общие строки, шрифты, объединённые ячейки, условное форматирование. Конвертер игнорирует всё, кроме видимых значений ячеек первого листа. Формулы не пересчитываются — используется то значение, которое было сохранено в файле последний раз. Если файл не открывался с момента последнего редактирования, формула может содержать кэшированный результат, но если формула не была вычислена, ячейка может быть пустой или содержать ошибку.
Что получается на выходе: структура и ограничения
После конвертации вы можете скачать JSON-файл, увидеть предпросмотр данных, а также информацию о количестве строк и столбцов и размере выходного файла. Все преобразования выполняются в браузере — ничего не уходит в интернет.
Ограничения и сообщения об ошибках:
| Условие | Сообщение |
|---|---|
| Файл не удаётся распарсить | «This Excel file could not be opened.» |
| Первый лист не содержит строк с данными | «This file has no table rows.» |
Размер файла превышает лимит ‹max› |
«This file is too large. Use a file under `‹max›.» |
Больше ‹max› строк или ‹max› столбцов |
Соответствующее сообщение (конкретные лимиты указаны на странице) |
| Загружен не XLSX, не CSV, не JSON | «Choose a CSV, JSON or XLSX file.» |
| Общая ошибка конвертации | «Could not convert this file.» |
| Конвертация отменена | «Conversion cancelled.» |
| Слишком долгое выполнение | «This conversion is too long. Try a smaller file.» |
Обратите внимание: конвертер читает только первый лист. Если ваши данные распределены по нескольким листам, нужно каждый лист сохранить как отдельный XLSX-файл и конвертировать по очереди. Объединённые ячейки не поддерживаются — будет взято значение только из верхней левой ячейки объединённого диапазона, остальные строки/столбцы станут пустыми. Пустые строки в начале или середине таблицы могут быть интерпретированы как отсутствие данных.
Типичные сценарии использования
Эта страница будет полезна:
- Веб-разработчику, который получает от клиента прайс-лист в Excel и должен передать его в виде JSON в API интернет-магазина. Типы цен (числа) и наличие (булево) сохранятся корректно.
- Аналитику данных, которому нужно быстро превратить ежеквартальный отчёт (XLSX) в JSON для машинной обработки — например, для загрузки в базу данных или для передачи коллегам, работающим с Python/Pandas.
- Команде, которая пересылает данные партнёрам, предпочитающим JSON, а не Excel, и хочет сделать это без установки дополнительных программ.
- Пользователю, заботящемуся о конфиденциальности: файл не покидает компьютер, поэтому никакие данные не передаются по сети.
Как происходит отображение типов ячеек
Excel хранит ячейки с типом: число (Number), дата (Date/Time), текст (String), логическое значение (Boolean), пусто (Empty/Null). Конвертер пытается передать эти типы в JSON как можно точнее.
- Числа преобразуются в числа JSON: целые — без дробной части, числа с плавающей точкой — с дробью.
- Логические — в
trueилиfalse. - Пустые ячейки — в
null. - Даты в Excel хранятся как серийные номера (например, 45292 = 27.12.2023). Конвертер преобразует их в строку формата ISO 8601 (
"2023-12-27T00:00:00.000Z"), если дата распознана. Если распознать не удаётся, остаётся число. - Текст — строка, взятая напрямую из ячейки.
Важно: проценты, денежные форматы, научные обозначения — это лишь отображение числа с форматированием. Конвертер не применяет форматирование: число 0.05 останется 0.05, а не "5%". Абсолютные ссылки, условное форматирование, цвета шрифтов — всё теряется.
Почему формулы не вычисляются и что с этим делать
XLSX-файл может содержать ячейки с формулами. В ZIP-архиве хранится как текст формулы, так и вычисленное значение (если файл был сохранён с результатом). Конвертер берёт последнее сохранённое значение, но не пересчитывает формулу. Если формула ссылается на другие ячейки, которые тоже внутри файла, но конвертер всё равно не вычисляет — он берёт только то, что записано в атрибуте <v> в XML.
На практике это означает: если вы создали таблицу с формулой =A1+B1, но не открыли Excel, чтобы она посчиталась, значение может быть пустым или нулём. Поэтому перед конвертацией откройте файл в Excel, дайте формулам посчитаться и сохраните. Или используйте специализированные инструменты, которые умеют вычислять формулы (например, на Python с библиотекой openpyxl в режиме data_only=False, но это уже не наша страница).
Как избежать типичных проблем после конвертации
Даже при корректной конвертации полученный JSON может потребовать дополнительной проверки.
- Объединённые ячейки. Если в исходной таблице заголовок объединён на два столбца, конвертер возьмёт текст только из первого столбца, второй заголовок будет пустым. Придётся вручную заполнить ключи в JSON или заранее «разъединить» ячейки в Excel.
- Пустые строки. Строки, где все ячейки пусты, обычно игнорируются, но если в таблице есть пустая строка посередине, она может появиться как объект со всеми значениями
null. - Строки с разным количеством элементов. Если у вас в одной строке больше столбцов, чем в другой, конвертер дополнит недостающие до максимального количества столбцов (значением
null). Рекомендуется, чтобы таблица была прямоугольной. - Несколько листов. Как уже сказано, обрабатывается только первый. Если данные на других листах, сохраните их отдельно.
- Скрытые столбцы/строки. Они тоже попадут в JSON, потому что конвертер читает все ячейки, независимо от видимости. Удалите ненужные строки/столбцы заранее.
- Даты с нераспознанным форматом. Если дата отображается в Excel как текст, а не как число даты, она попадёт в JSON как строка. Убедитесь, что ячейки с датами имеют числовой формат даты.
FAQ
1. Почему в выходном JSON хранятся числа в кавычках, хотя в Excel они были числами?
Скорее всего, ячейка имела текстовый формат. Excel может хранить числа как текст (например, при импорте из другого источника). Измените формат ячейки на «Общий» или «Числовой» в Excel и повторно сохраните файл.
2. Как конвертировать данные не из первого листа?
Страница позволяет обработать только первый лист. Временно скопируйте нужный лист в новый XLSX-файл и загрузите его.
3. Что произойдет с датами после конвертации?
Даты преобразуются в строки ISO 8601 (например, "2023-12-27T00:00:00.000Z"), если Excel хранит их как серийные числа. Если даты хранятся как текст, останутся строками в исходном виде.
4. Есть ли ограничение на размер файла или количество строк?
Да, на странице указаны лимиты «‹max›». Если ваш файл превышает их, появится сообщение об ошибке. Попробуйте разбить файл на части или удалить лишние данные.
5. Как быть с объединенными ячейками?
Значение будет взято только из левой верхней ячейки объединенного диапазона, остальные ячейки станут пустыми (null). Для корректного результата заранее разъедините ячейки и продублируйте значения.
6. Можно ли конвертировать XLS (старый формат) в JSON?
Нет. Страница принимает только XLSX (формат Office Open XML). Для XLS используйте другое средство (например, сохраните как XLSX в Excel).
Эта страница — простой, локальный и предсказуемый инструмент для одного конкретного преобразования. Если ваши данные аккуратно организованы и не содержат сложных формул или множества листов, результат будет готов за секунды.