Excel JSON 변환기

통합 문서 제한 및 지원 형식

이 변환기는 XLSX 및 이전 이진 XLS 통합 문서를 읽습니다. XLSM, XLSB, ODS, CSV 파일은 허용하지 않습니다. 브라우저가 파일 서명을 검증하므로 다른 형식의 이름만 .xlsx 또는 .xls로 바꿔서는 변환할 수 없습니다.

통합 문서 하나는 20 MiB 이하, 워크시트는 최대 100개, 셀은 최대 200만 개까지 사용할 수 있습니다. 변환기는 읽기 전에 XLSX 아카이브 구조도 검사하고 출력이 100 MiB를 넘으면 생성을 멈춥니다. 이 제한은 손상되었거나 유난히 큰 통합 문서가 제어할 수 없는 브라우저 다운로드를 만드는 일을 막습니다.

선택한 시트에 공통으로 적용할 JSON 구조 선택

JSON은 배열과 객체뿐 아니라 문자열, 숫자, 불리언, null도 표현할 수 있습니다. 알맞은 구조는 파일을 읽을 시스템에 따라 달라집니다. RFC 8259는 JSON 데이터 모델을 설명합니다.

객체 배열 형식은 SheetJS에 설명된 기본 동작을 따릅니다. 첫 행이 헤더가 됩니다. 행렬 출력에서는 그 행도 메타데이터가 아니라 데이터이므로 유지됩니다.

객체, 사전, 그룹화 출력에는 비어 있지 않고 중복되지 않는 헤더 행이 필요합니다. 사전 출력에는 선택한 키 열의 고유 값도 필요합니다. 이 규칙을 만족하지 않으면 변환기는 레코드를 조용히 덮어쓰는 대신 명확한 오류와 함께 중단합니다. 이후 시스템이 통합 문서의 원래 표기를 요구할 경우, 정리된 속성 키 대신 정확한 헤더 텍스트를 유지할 수 있습니다.

값, 날짜 및 수식

유형 추론을 사용하면 스프레드시트의 숫자와 불리언은 JSON 숫자와 불리언으로 유지됩니다. 받는 시스템에서 형 변환을 직접 제어한다면 값을 문자열로 유지할 수도 있습니다. 빈 셀은 null 또는 빈 문자열이 될 수 있습니다. JavaScript의 안전한 정수 범위를 벗어나는 정수는 자릿수가 조용히 반올림되지 않도록 문자열로 남습니다.

날짜 셀은 스프레드시트 판독기가 날짜로 인식할 때만 ISO 값이 됩니다. 변환기는 날짜처럼 보이는 텍스트를 날짜라고 추측하지 않습니다. 이는 주문 번호, 버전 레이블, 로케일별 날짜 텍스트 같은 값에서 중요합니다.

변환기는 Excel 수식을 실행하거나 다시 계산하지 않습니다. 수식에 캐시된 값이 있으면 캐시된 셀 값을 사용하며, 서식이 적용된 표시 결과는 사용하지 않습니다. 캐시된 값이 없는 수식은 빈 값 설정을 따릅니다.

브라우저 내 변환 및 임시 초안

통합 문서 읽기, JSON 생성, ZIP 만들기, 다운로드는 모두 브라우저에서 이루어집니다. 통합 문서, 시트 데이터, 생성된 JSON은 업로드되거나 당사 서버를 통해 전송되지 않습니다.

여러 단계 흐름에서는 검증된 통합 문서를 해시 확인을 거친 임시 초안으로 이 브라우저의 IndexedDB에 보관할 수 있습니다. URL에는 불투명한 작업 식별자만 들어가며 파일 이름이나 워크시트 값은 들어가지 않습니다. 초안은 30분 뒤에는 사용할 수 없습니다. 다시 시작하거나 다운로드를 요청하면 이 도구가 브라우저에 초안을 제거해 달라고 요청하며, 제거를 확인할 수 없으면 공유 기기를 떠나기 전에 이 사이트 데이터를 지우라는 경고가 표시됩니다. 브라우저 저장소를 사용할 수 없으면 제어 요소가 한 페이지에 남아 있으므로 페이지 이동 없이도 변환을 마칠 수 있습니다.