XLSX から JSON への変換はなぜ単なる形式変換ではないのか
XLSX ファイルは ZIP 圧縮された XML ワークブックであり、複数のシート、セルタイプ（テキスト、数値、日付、ブール値）、数式、書式情報を保持できる。一方 JSON は、オブジェクト、配列、数値、真偽値、null といった型付きの入れ子構造を持つ。この差異が、XLSX→JSON 変換を XLSX→CSV 変換と根本的に異なるものにする。CSV はあらゆる値を文字列としてフラットに書き出すが、このツールは数値やブール値を元の型のまま JSON の数値や真偽値として保持する。ただし、XLSX テーブル自体に階層構造はなく、変換結果はフラットなオブジェクトの配列となる。セルの書式（フォント、色、罫線）や数式（未計算）はすべて破棄される。
ブラウザ内で完結する処理の実態
変換はすべて訪問者のブラウザ上で行われる。XLSX ファイルはサーバーに送信されない。ブラウザがワークブックを解析し、変換された出力をデバイスに書き込む。この仕組みにより、機密データを含む Excel ファイルを外部に送信することなく変換できる。ファイル選択ダイアログまたはドラッグ&ドロップで XLSX ファイルを指定すると、即座に解析が開始される。出力形式は JSON 固定であり、結果はプレビュー表示とともにダウンロード可能な JSON ファイルとして提供される。変換後のテーブルの行数・列数、出力ファイルのサイズも表示される。
セルタイプのマッピング：Excel の値が JSON でどう表現されるか
| 元のセルの内容（Excel） | JSON での表現 |
|---|---|
| 数値（例：123.45） | 数値（123.45、引用符なし） |
| 文字列（例："東京"） | 文字列（"東京"、引用符付き） |
| ブール値（TRUE / FALSE） | 真偽値（true / false） |
| 日付（例：2024年1月15日） | ISO 8601 形式の文字列（例: "2023-08-15T00:00:00.000Z"） |
| 数式（例：=A1+B1） | 最後に保存された表示値（数式結果ではない） |
日付は ISO 8601 形式の文字列として UTC で出力される。ユーザー側で異なる形式が必要な場合は、JSON を後処理する必要がある。数式は計算されず、元のファイル保存時点の表示値が使われる。空のセルは空文字列になる。
制限とエッジケース
- 最初のシートのみ読み取り：複数のシートが存在しても、最初のワークシートのデータだけ変換される。他のシートのデータを変換したい場合は、該当シートを含む別の XLSX ファイルを別途処理する必要がある。
- セルの書式はすべて破棄：フォント、色、罫線、塗りつぶし、セルの結合、条件付き書式は JSON に反映されない。マージされたセルは左上のセルの値のみが残り、結合範囲の他のセルは空文字列になる。
- ファイルサイズと行/列の制限：ファイルは最大 8 MB、テーブルは最大 10,000 行および 200 列 に制限される。これらの制限を超過すると、変換は停止し、適切なエラーが表示される。
- エラーメッセージ一覧：
- 「このExcelファイルを開けませんでした」
- 「このファイルにはテーブル行がありません」
- 「CSV、JSON、XLSXファイルを選択してください」
- 「このファイルを変換できませんでした」
- 「変換がキャンセルされました」
- 「このファイルは大きすぎます。‹max› 未満のファイルを使用してください。」
- 「この変換には時間がかかりすぎています。より小さいファイルを試してください。」
具体的なユースケース：誰がこのツールを必要とするか
- Web 開発者：取引先から受け取った Excel 製品リストをそのまま JSON API の入力値として使いたい。数値や真偽値が引用符で囲まれずに保持されるため、スキーマ検証を通過しやすい。
- データアナリスト：四半期レポートの XLSX を JSON に変換し、Python や R などのプログラムで更に加工する。アップロードを避けられるため、社内機密情報の漏洩リスクが減る。
- 外部連携チーム：JSON を標準形式とするパートナー企業とデータをやり取りする際、XLSX をワンタイム変換する。ソフトウェアインストール不要で、ブラウザが使える環境ならどこでも機能する。
- プライバシー意識の高いユーザー：人事データや財務データなどの機密情報を含む XLSX をクラウドサービスに預けずに変換したい。クライアントサイド処理により、ファイルがネットワークを経由することは一切ない。
よくある質問（FAQ）
Q: 変換後の JSON で数式の計算結果が正しくありません。なぜですか？ A: このツールは数式を計算しません。そのセルに保存されている「表示値」（元ファイルを最後に保存した時点の値）を使用します。最新の計算結果を得るには、Excel 側で数式を計算した状態でファイルを保存し直してください。
Q: 複数のワークシートを一度に変換できますか？ A: できません。変換対象は常に最初のワークシートだけです。別のシートのデータが必要な場合は、そのシートだけを新しい XLSX ファイルとして保存し、再度変換してください。
Q: 日付が数値（44927 など）になってしまいます。日付文字列にする方法は？ A: このツールは日付を ISO 8601 形式の文字列として出力します。元の Excel の書式マスクは破棄されます。特定の形式が必要な場合は、ISO 文字列を後処理する必要があります。
Q: 変換できるファイルサイズの上限はいくつですか？ A: ファイルは 8 MB に制限されています。テーブルは 10,000 行および 200 列に制限されています。いずれかの制限を超過すると、明確なエラーメッセージとともに変換が停止します。
Q: 変換後に出力される JSON の行数・列数は元のシートと常に一致しますか？ A: 原則として一致しますが、完全に空の行はドロップされます。また、マージされたセルは左上の値のみが保持され、それ以外のセル値は欠落するため、結果的に行数・列数が減少する場合があります。
Q: 変換中に「この変換は時間がかかりすぎています。より小さいファイルを試してください。」と表示されました。どうすればいいですか？ A: 変換が約 12 秒の制限を超過した場合に表示されます。通常、ワークブックが非常に大きいことが原因です。行数や列数を減らすなどして、XLSX をより小さなファイルに分割し、それぞれを個別に変換することが有効です。