Какво прави тази страница
Качвате Excel файл (XLSX) и получавате обратно JSON файл, съдържащ структурирана таблица от първия работен лист. Цялата обработка се извършва изцяло в браузъра ви – нищо не се качва на сървър. Таблицата се превръща в масив от обекти, като имената на колоните стават ключове, а стойностите – подходящо типизирани JSON стойности. Накрая можете да изтеглите JSON файла, да видите преглед на резултата, да проверите броя на редовете и колоните, както и размера на изходния файл.
Какво отличава този инструмент от други
Преобразуването XLSX → JSON не е същото като XLSX → CSV. XLSX файлът е компресиран ZIP архив, съдържащ XML структура, която може да носи множество листове, различни типове клетки (текст, число, дата, булева стойност), формули и богато форматиране. JSON, от друга страна, е типизиран влагаем формат – поддържа обекти, масиви, числа, булеви стойности и null. При конвертиране числовите и булевите клетки могат да бъдат запазени като реални JSON типове, а не просто като низове с кавички.
CSV изравнява всеки ред в обикновен текстов ред, докато JSON представя таблицата като масив от обекти с колони като ключове. Важно: изходната XLSX таблица е плоска – няма автоматично генерирана йерархия. Ако имате нужда от вложени JSON структури, трябва да ги създадете отделно.
Типовете клетки се запазват: число остава число (напр. 123), булево остава true/false, а датите се превръщат в низове (обикновено в ISO формат). Текстовите клетки остават низове. Празна клетка става "".
Ключово предимство: обработката е изцяло клиентска. Браузърът разопакова XLSX и записва конвертирания изход на вашето устройство. Вашите данни не напускат компютъра. Това е съществено за поверителността – няма риск от изтичане на фирмена информация.
Как работи преобразуването в браузъра
Когато изберете или пуснете файл, браузърът чете XLSX като ArrayBuffer и го декомпресира в паметта. Открива се първият работен лист – всички останали се игнорират. Редовете се обхождат: първият ред по подразбиране се третира като заглавен (имена на колони), а останалите като данни. Ако заглавният ред съдържа дублиращи се стойности, те получават суфикси _2, _3 и т.н..
Формулите не се преизчисляват. Взема се само последната запазена стойност на клетката – ако формулата =A1+B1 не е била изчислена и записана, резултатът може да е празен или грешка. Форматирането (шрифтове, цветове, граници, обединени клетки) се изхвърля. Ако имате обединени клетки, само горната лява клетка носи стойността, останалите стават празни низове. Това може да създаде непопълнени редове в JSON; препоръчва се предварително да „разширите“ обединените клетки в Excel.
След парсване на данните се генерира JSON низ, който се показва като преглед, а също и се предлага за изтегляне като файл с разширение .json. Размерът на изходния файл се изчислява и показва.
Ограничения и гранични случаи
Инструментът има твърди лимити, които не могат да бъдат заобиколени. Файлът е ограничен до 8 MB, а таблиците до 10 000 реда и 200 колони. Ако някое ограничение бъде надвишено, се появява грешка: „Този файл е твърде голям. Използвайте файл под ‹max›.“
Други грешки при конвертиране:
| Сценарий | Съобщение |
|---|---|
| Невалиден XLSX | „Този Excel файл не може да бъде отворен.“ |
| Първият лист е празен | „Този файл няма редове в таблицата.“ |
| Неподдържан формат (например PDF) | „Изберете CSV, JSON или XLSX файл.“ |
| Друга грешка при обработка | „Не може да се конвертира този файл.“ |
| Отменено от потребителя | „Конвертирането е отменено.“ |
| Твърде дълго обработване | „Това конвертиране отнема твърде много време. Опитайте с по-малък файл.“ |
Важно: ако файлът съдържа хитър формат като стари Excel двоични файлове (XLS, не XLSX) или защитен с парола, инструментът няма да го разпознае и ще покаже съобщението за невъзможност за отваряне. Поддържа се само XLSX (Open XML формат).
Съпоставяне на типове клетки
За да разберете точно какво получавате, е полезно да знаете картографирането:
Excel тип → JSON тип
- Текст ("Здравей") →
"Здравей"(String) - Число (123) →
123(Number) - Булево (TRUE) →
true(Boolean) - Дата (1 януари 2024) →
"2024-01-01T00:00:00.000Z"(String, ISO 8601) - Празна клетка →
"" - Грешка (#REF!, #DIV/0!) → в JSON се появява като низ, съдържащ текстовата грешка.
Ако искате да запазите числата точно без загуба на точност, XLSX съхранява числа с плаваща запетая с 15 значещи цифри. JSON също използва IEEE 754, така че няма допълнителна загуба. За точни числа (напр. финансови) трябва да съхранявате стойностите като низове в Excel или да ги форматирате предварително.
Булевите стойности се запазват само ако са въведени директно като TRUE/FALSE в клетката. Ако стойността идва от формула, тя се записва като резултат – булевият резултат ще бъде true или false.
За кого е предназначен този инструмент
- Уеб разработчик, който получава продуктови данни в Excel и трябва да ги превърне в JSON за API или преден край.
- Анализатор на данни, който иска бързо да трансформира тримесечен отчет (XLSX) в машинночетим JSON за по-нататъшна обработка.
- Екип, работещ с външни партньори, които предпочитат JSON пред Excel – необходим е еднократен конвертор без инсталиране на софтуер.
- Всеки, който цени поверителността и иска да конвертира XLSX в JSON, без да го качва в облачен сървис – обработката е изцяло локална.
Често задавани въпроси
1. Защо датите се конвертират като низове, а не като числа? В XLSX датите се съхраняват като поредни числа (ден поред от 1900 г.), но са форматирани като дати. При конвертиране инструментът ги превръща в низове във формат ISO 8601, за да са четливи. Ако трябва да работите с числови времеви стойности, конвертирайте колоната в число в Excel преди качване.
2. Какво става с формулите? Не се изчисляват. Инструментът взема последната запазена стойност на клетката. Ако файлът не е бил записан след изчисление, резултатът може да е празен или да има грешка. Винаги запазвайте Excel файл с изчислени стойности преди конвертиране.
3. Мога ли да получа данни от втори или трети лист? Не. Инструментът чете само първия лист. Ако имате нужда от други листове, трябва да ги експортирате като отделни XLSX файлове или да използвате друг инструмент, който поддържа множество листове.
4. Как да проверя дали обединените клетки се конвертират правилно?
Обединените клетки нямат стойност в празните си части. В JSON ще видите празни низове ("") в редовете, където липсва текст. Препоръчва се преди конвертиране да „разширите“ обединените клетки (Unmerge cells) и да попълните дублираните стойности.
5. Има ли ограничение за размера на файла? Да. Файловете са ограничени до 8 MB, а таблиците до 10 000 реда и 200 колони. Ако някое ограничение бъде надвишено, конвертирането спира с ясно съобщение за грешка.
6. Защо не просто да копирам-поставя от Excel в JSON редактор? Защото ръчното копиране губи типовете – числата стават текст, булевите стойности се обръщат в низове, а сложното форматиране на XLSX, като дати, изисква допълнителна обработка. Този инструмент прави точното картографиране автоматично, без риск от грешки.