تحويل CSV إلى JSON
مع تفعيل سطر العناوين، يصبح ملف CSV المكوّن من السطرين «name,age» ثم «Ada,36» هو [{"name":"Ada","age":36}]. يتحول كل سطر إلى كائن مفاتيحه أسماء العناوين. وتحوّل الأداة أيضًا من JSON إلى CSV.
طريقة الاستخدام
- اختر الاتجاه من CSV إلى JSON أو من JSON إلى CSV، والصق بياناتك في مربع الإدخال. يوجد مثال محمّل لترى الصيغة.
- اختر الفاصل الذي يستخدمه ملفك: فاصلة، أو فاصلة منقوطة، أو جدولة، أو خط عمودي. ملفات Excel المحفوظة بإعدادات إقليمية تستخدم الفاصلة العشرية تستعمل عادةً الفاصلة المنقوطة.
- عند التحويل من CSV إلى JSON، إذا بقي خيار «السطر الأول عناوين» مفعّلًا تحصل على مصفوفة كائنات، وإذا ألغيته تحصل على مصفوفة مصفوفات. وإذا فعّلت «تحويل الأرقام وقيم true/false» تُكتب 36 رقمًا لا النص "36".
- انسخ الناتج. وإذا تعذّرت قراءة المدخلات تخبرك الرسالة بالخطأ وموضعه.
طريقة الحساب
يتبع قارئ CSV المعيار RFC 4180. الحقل المحاط بعلامتي اقتباس مزدوجتين يمكن أن يحتوي فواصل وفواصل أسطر، وتُكتب علامة الاقتباس داخله مرتين. يمكن أن تنتهي الأسطر بـLF أو CRLF أو CR، ويُتجاهل BOM في البداية، وتُتخطى الأسطر الفارغة.
مع تفعيل سطر العناوين يعطي السطر الأول المفاتيح. العناوين الفارغة تصبح column_N، والعناوين المكررة يُضاف إليها رقم مثل name_2، فلا تُكتب قيمة فوق أخرى. في الأسطر الأقصر من العناوين تُملأ الخلايا الناقصة بنص فارغ، وفي الأسطر الأطول تُضاف الخلايا الزائدة بمفاتيح column_N. ويظهر عدد هذه الأسطر في سطر الحالة.
تحويل الأنواع اختياري وحذر. لا تُحوَّل إلا الأرقام العادية (42 و-3.5 و1e3) والكلمتان true وfalse. أما القيم التي تبدأ بصفر مثل 02134، وذات الإشارة مثل +5، والأعداد الصحيحة الأكبر من أن تُخزَّن بدقة، فتبقى نصًا.
يقبل التحويل من JSON إلى CSV مصفوفة كائنات، أو مصفوفة مصفوفات، أو مصفوفة قيم بسيطة، أو كائنًا واحدًا. في الكائنات تكون الأعمدة اتحاد كل المفاتيح بترتيب أول ظهور لها. المفاتيح الناقصة وnull تصبح خلايا فارغة، والكائنات والمصفوفات المتداخلة تُكتب في الخلية نص JSON. ولا تُقتبس الخلية إلا إذا احتوت الفاصل أو علامة اقتباس مزدوجة أو فاصل أسطر.
كيف تنتقل خلايا CSV إلى JSON
| خلية CSV | وضع النص | مع تحويل الأنواع |
|---|---|---|
| 36 | "36" | 36 |
| -3.5 | "-3.5" | -3.5 |
| true | "true" | true |
| 02134 | "02134" | "02134" |
| "" | "" | |
| "a,b" | "a,b" | "a,b" |
أسئلة شائعة
لماذا تظهر أرقامي نصوصًا في JSON؟
لا توجد أنواع بيانات في CSV، فكل خلية نص. عند تفعيل «تحويل الأرقام وقيم true/false» تصبح الأرقام والقيم المنطقية أرقام JSON وقيمًا منطقية. أما القيم التي تبدأ بصفر مثل الرموز البريدية فتُترك نصًا عمدًا.
هل يمكن أن تحتوي الخلية فاصلة أو فاصل أسطر؟
نعم، ما دامت الخلية محاطة بعلامتي اقتباس مزدوجتين، مثل "Smith, John". وتُكتب علامات الاقتباس داخل الخلية مرتين: "He said ""hi""". تقرأ الأداة الحالتين وتكتبهما.
ملفي يستخدم الفاصلة المنقوطة أو الجدولة. ماذا أفعل؟
اختر الفاصل المناسب من القائمة. في المناطق التي تستخدم الفاصلة فاصلًا عشريًا يحفظ Excel ملفات CSV بالفاصلة المنقوطة. وتُسمى الملفات المفصولة بالجدولة أيضًا TSV.
ما نوع JSON الذي يمكن تحويله إلى CSV؟
الأفضل مصفوفة كائنات مثل [{"a":1},{"a":2}]. وتعمل أيضًا مصفوفة المصفوفات ومصفوفة القيم البسيطة. ولأن CSV جدول مسطح، تبقى الكائنات المتداخلة نص JSON في خلية واحدة.
هل يستخدم الناتج نهايات أسطر CRLF؟
يستخدم الناتج LF العادي، وتفتحه كل برامج الجداول والمحررات بشكل صحيح. وعند القراءة تُقبل LF وCRLF وCR.
هل تُرفع بياناتي؟
لا. يجري التحويل بالكامل في متصفحك، ولا تغادر جداولك جهازك.