JSON ⇔ CSV Converter

JSON ⇔ CSV Converterとは？

JSON ⇔ CSV Converterは、Web APIやプログラムでよく使われるJSON形式と、表計算ソフトや業務システムで広く使われるCSV形式を相互に変換するためのツールです。JSONはオブジェクトや配列を使って構造化されたデータを表現できる一方、CSVは行と列からなる単純な表形式なので、Excelやスプレッドシートへの取り込み、一覧データの確認、他システムへの受け渡しに向いています。APIから取得したJSONをCSVとして保存したい場合や、CSVの一覧データをJavaScriptやAPIで扱えるJSONへ変換したい場合に利用できます。

JSONからCSVへ変換する場合は、基本的に同じ種類の項目を持つオブジェクトの配列を入力します。たとえばname、price、stockを持つ商品オブジェクトが複数並んだJSONなら、それぞれのキーがCSVの列見出しになり、各オブジェクトが1行として出力されます。項目が一部の行にしか存在しない場合も、すべてのキーを収集して列を作り、値がないセルは空欄として扱います。ネストしたオブジェクトは「ネストしたJSONをドット記法で展開する」を有効にすると、address.cityのような列名へ展開できます。

CSVからJSONへ変換する場合は、先頭行を列名として扱い、2行目以降をオブジェクトへ変換します。CSVではすべての値が文字として表現されるため、「型を推定する」を有効にすると、123を数値、trueやfalseを真偽値、nullをnullとして変換できます。商品コードや郵便番号のように先頭の0が重要なデータは文字列として保持する必要があるため、このような用途では型推定をオフにするのがおすすめです。

CSVの区切り文字はカンマだけでなく、タブ、セミコロン、パイプにも対応しています。タブを選べばTSVとして利用できます。セル内にカンマ、改行、ダブルクォートが含まれる場合は、CSVの一般的なルールに従ってダブルクォートで囲み、内部のダブルクォートを二重化して出力します。そのため、単純な文字列置換では壊れやすい文章や説明文を含むデータにも対応できます。

このツールの変換処理はJavaScriptを利用してブラウザ内で行われ、入力したJSONやCSVファイルを変換のためにサーバーへアップロードしません。顧客データや社内データなどを扱う場合でも外部サーバーへ送信する方式を避けられます。ただし、共有端末、ブラウザ拡張機能、端末自体のセキュリティなどについては別途注意してください。非常に大きなデータはブラウザのメモリを多く消費するため、必要に応じてデータを分割して利用してください。

主な機能

• JSONのオブジェクト配列をCSV・TSVへ変換できます。
• CSV・TSVをJSONのオブジェクト配列へ変換できます。
• カンマ、タブ、セミコロン、パイプ区切りに対応しています。
• ネストしたJSONオブジェクトをドット記法の列へ展開できます。
• CSVからJSONへの変換時に数値・真偽値・nullの型を推定できます。
• JSONの整形表示を切り替えられます。
• 結果をコピーしたり、CSV・TSV・JSONファイルとして保存できます。
• 入力データはサーバーへ送信せずブラウザ内で処理します。重い変換はWeb Workerで実行し、処理中でも画面操作を止めにくい設計です。

JSON ⇔ CSV Converterの使い方

1. 「JSON → CSV」または「CSV → JSON」から変換方向を選びます。
2. 入力欄へデータを貼り付けるか、JSON・CSV・TSVファイルを選択します。
3. CSVの区切り文字、JSONのネスト展開、CSV値の型推定など必要な設定を選びます。
4. 「変換する」を押すと結果が表示されます。結果欄が画面外の場合は自動で移動します。
5. 内容を確認し、「結果をコピー」または「ダウンロード」を利用します。
6. 大きなデータで端末負荷を抑えたい場合は「低負荷モード」を有効にします。処理中は進捗表示と「処理を中断」ボタンを利用できます。
7. 反対方向へ変換したい場合は「変換方向を入れ替える」で結果を入力側へ移して続けて変換できます。

利用時の注意

• JSON → CSVは表形式へ変換できるデータを対象としており、複雑な階層の配列は完全には表現できません。
• CSVの型推定を有効にすると、00123のような値を数値にせず文字列として保持するため、先頭0を持つ値は自動的に文字列として扱います。
• CSVからJSONへ変換するときは、先頭行を項目名として使用します。重複する列名があると後の値で上書きされるため、列名は一意にしてください。
• 大容量データは端末のメモリや処理時間に影響するため、20MB以下を目安に利用してください。

JSON ⇔ CSV Converterのよくある質問

JSONからCSVへ変換するには、どのようなJSONを入力すればよいですか？

基本的にはオブジェクトの配列を入力します。1つのオブジェクトだけでも1行のCSVとして変換できます。

ネストしたJSONもCSVにできますか？

はい。「ネストしたJSONをドット記法で展開する」を有効にすると、address.cityのような列名へ展開できます。

配列を含むJSONはどうなりますか？

オブジェクト内の配列は、CSVの1セルに収めるためJSON文字列として出力します。複雑な多次元データは事前に構造を整理することをおすすめします。

CSVからJSONへ変換すると数値になりますか？

型推定を有効にすると、一般的な数値、true、false、nullをそれぞれJSONの型へ変換します。オフの場合はすべて文字列になります。

00123のような先頭0の値は保持できますか？

はい。型推定を有効にしていても、先頭0を持つ整数形式の値は文字列として保持するようにしています。

TSVにも対応していますか？

はい。区切り文字で「タブ（TSV）」を選択すると、JSONとTSVの相互変換ができます。

セル内にカンマや改行があるCSVも変換できますか？

CSVのルールに従ってダブルクォートで囲まれていれば、セル内のカンマ、改行、ダブルクォートを解析できます。

JSONやCSVはサーバーへ送信されますか？

いいえ。ファイルの読み込みと変換はブラウザ内のJavaScriptで処理します。

変換結果をファイルとして保存できますか？

はい。変換方向に応じて.csv、.tsv、.json形式でダウンロードできます。

CSVの列順はどう決まりますか？

JSON内に登場するキーを先頭のオブジェクトから順に収集し、新しいキーが現れた場合は後ろへ追加します。

CSVの先頭行は必須ですか？

CSV → JSONでは先頭行をJSONのキーとして使用するため、列名を含むヘッダー行が必要です。

Excelファイルを直接変換できますか？

このツールはJSON、CSV、TSVを対象としています。.xlsxファイルはCSVとして保存してから利用してください。

大きなファイルでブラウザが重くなる場合はどうすればよいですか？

低負荷モードを有効にすると処理を小分けにして休止を挟みます。また、変換処理はWeb Workerで実行するため画面が固まりにくく、処理中は中断ボタンで停止できます。