XLSX を JSON に変換

手作業で作った Excel の表を、プログラムやシステムに読み込ませたい場面でこの変換を使います。JSON はほとんどのプログラミング環境がそのまま扱える形式です。

この変換が対象にするのは、ブックの中の最初のシートだけです。2 枚目以降にどれだけ重要なデータがあっても、変換結果には反映されません。

複数シートのデータをすべて JSON にしたい場合は、シートごとに個別のファイルへ分けてから、それぞれを変換する必要があります。

数式が入力されているセルは、その計算式ではなく、Excel が最後に計算した結果の値だけが取り込まれます。数値の表示形式、結合されたセル、グラフ、画像、列幅、行の高さ、セルの色や罫線、入力規則、名前付き範囲、ピボットテーブルは、いずれも読まれません。

コメントも対象外です。この変換が持ち出すのは、表の見た目や仕組みではなく、純粋にセルの中身の値だけです。

1 行目は見出しとして扱われ、各列の名前がそのまま出力される JSON オブジェクトのキーになります。2 行目以降がそれぞれ 1 つのオブジェクトに対応します。

Excel の日付セルは内部的にはシリアル値という数値で保存されています。この変換がその数値をそのまま渡すのか、日付らしい形式に変換するのかは、ファイルの内容によって挙動が変わる可能性があり、ここで確実な仕様として断言できません。

日付を含む表を変換した場合は、出力された値が期待どおりの形式になっているか、必ず確認することを勧めます。

値が入力されていないセルは、JSON の中では `null` として書き出されます。0 や空文字列と区別されるので、値が本当に入力されていなかったのか、0 が入力されていたのかを後から区別できます。

複数の XLSX ファイルを一度に置いても、順番に処理されて ZIP にまとめて返ってきます。アップロードは発生しませんが、1 回にまとめられるのは 100 ファイルまでです。行数の多い表ほど処理に時間がかかりますが、実際の制約は端末の空きメモリーです。