CSV-ის JSON-ში კონვერტერი

CSV-დან JSON-ში გარდაქმნის ინსტრუმენტი: რატომ განსხვავდება ეს გვერდი

CSV-ს (Comma-Separated Values) ფაილი, რომელიც შეიცავს მძიმით, წერტილ-მძიმით ან ტაბულაციით გამოყოფილ ტექსტურ მონაცემებს, ხშირად საჭიროებს JSON-ში (JavaScript Object Notation) გარდაქმნას. ტიპიური შედეგია ობიექტების მასივი, სადაც ყოველი CSV-ს სტრიქონი ხდება ცალკე ობიექტი, ხოლო ყოველი სვეტი — გასაღები. ინსტრუმენტი მოქმედებს მარტივი ინტერფეისით: გადაათრიეთ CSV ფაილი, აირჩიეთ JSON ფორმატი, მიუთითეთ delimiter (მძიმე, წერტილ-მძიმე ან ტაბულაცია), იხილეთ გადაადგილების წინასწარი ნახვა და ჩამოტვირთეთ შედეგი.

რა ხდის ამ გვერდს განსხვავებულს

ამ ინსტრუმენტის ძირითადი მახასიათებელია ის, რომ CSV ფორმატში ტიპები არ არსებობს. CSV ინახავს ყველაფერს ტექსტის სახით — ნომრები, თარიღები, ლოგიკური მნიშვნელობები (true/false) — ყველაფერი ხდება string. JSON-ში გარდაქმნისას ყოველი ველი ტოვებს ტექსტის ფორმას, გარდა იმ შემთხვევისა, როდესაც JSON-ის მიმღები გარემო (მაგ., JavaScript-ის parser) არ ცდილობს მის ტიპირებას. ეს ნიშნავს, რომ ფასები, რაოდენობები, იდენტიფიკატორები თავდაპირველად რჩება ტექსტად; თქვენ მოგიწევთ ხელით გარდაქმნა, თუ ნომერი ან null გჭირდებათ.

ბუდირება (nesting) შეუძლებელია. CSV-ს ბრტყელი (flat) ცხრილის ფორმატი იძლევა მხოლოდ ბრტყელი ობიექტების მასივს. იერარქიული JSON (ობიექტები ობიექტებში) ვერ იქმნება CSV-დან დამატებითი წესების გარეშე. (საპირისპირო მიმართულება — JSON-დან CSV-ში — მოითხოვს ბრტყელობას.)

Delimiter-ის არჩევა აქტუალურია. CSV-ს delimiter-ი (მძიმე, წერტილ-მძიმე ან ტაბულაცია) ინსტრუმენტმა უნდა იცოდეს; JSON-ის ან Excel-ის შემთხვევაში მსგავსი არჩევანი არ არის.

Embedded commas (ჩასხმული მძიმეები) და line breaks (სტრიქონების წყვეტა) მყიფეა. CSV-ს quoting წესები (ციტატების გამოყენება) ყოველთვის არ იცვლება ყველა ინსტრუმენტის მიერ; ხშირად, ციტატებში ჩასხმული მძიმეები, უჯრაში line breaks-ები და unescaped quotes იწვევს parse-ის შეცდომებს.

CSV-ს ფორმატის ფუნდამენტები: delimiters, quoting, line breaks

CSV-ს ფორმატი, RFC 4180-ის მიხედვით, იყენებს delimiter-ს (მძიმეს) ველების გამოსაყოფად. თუმცა, www-ზე ხშირად გვხვდება semicolon (;) ან tab (\t) delimiter-ები, განსაკუთრებით იქ, სადაც CSV-ს locale-დამოკიდებულია (მაგ., გერმანულენოვან ქვეყნებში, სადაც მძიმე გამოიყენება როგორც decimal separator). ინსტრუმენტი იძლევა ამ სამი delimiter-ის არჩევის შესაძლებლობას; თუ აირჩევთ არასწორ delimiter-ს, CSV-ს ველები გაიყოფა შეცდომით.

Quoting rules: CSV-ში, ველი, რომელიც შეიცავს delimiter-ს, line break-ს ან quote-ს, უნდა იყოს ჩასმული quote (")-ში. თუ quote-ის გამოყენება გსურთ, ის უნდა იყოს "escaped" – ანუ, quote-ები იწერება ორჯერ (""). ისინი, ვინც CSV-ს იძენს Excel-დან ან Google Sheets-დან, ხშირად იღებენ quotes-ის სწორი მართვით; მაგრამ, quotes-ის უგულებელყოფა (unclosed quotes, double quotes-ის ნაცვლად single quotes-ის გამოყენება) იწვევს parse-ის შეცდომებს, რაც ინსტრუმენტი იცნობს: "This CSV could not be parsed."

Line breaks inside quoted fields: CSV-ს ზოგიერთი ველი შეიცავს line break-ს (\n) quote-ებში. ინსტრუმენტი ინახავს მათ JSON-ის string-ებში, როგორც \n. (Case example: CSV-ში "John\nDoe" იქცევა JSON-ში "John\\nDoe".)

JSON-ის სტრუქტურა ცხრილური მონაცემებისთვის

JSON-ში გარდაქმნისას, CSV-ს ცხრილი იქცევა array of objects-ად. ყოველ ობიექტს აქვს იგივე keys (სვეტების სახელები), ხოლო values – ტექსტი. (Example: CSV: name,age,city; John,30,New York -> JSON: [{"name":"John","age":"30","city":"New York"}].) თუ CSV-ს აქვს header-ის სტრიქონი (რაც ჩვეულებრივია), ის keys-ების წყაროა; თუ header-ი არ არის, ინსტრუმენტი იყენებს "column_1", "column_2" ან მსგავსი default-ის.

Row count and column count: ინსტრუმენტი აჩვენებს CSV-ს მონაცემების rows (სტრიქონების) და columns (სვეტების) რაოდენობას. (Example: "10 rows, 4 columns" მიუთითებს, რომ JSON-ის array 10 ობიექტს შეიცავს.) File size (kb/mb) და output size ნაჩვენებია; size-ის ზრდა სავარაუდოა (CSV-ს შედარებით, JSON-ს აქვს curly braces, quotes).

ტიპების სისტემა: text vs. typed values

CSV-ში ყველა ველი ტექსტია. ინსტრუმენტი არ იყენებს ინტერპრეტაციას numbers, booleans ან null. (This differs from JSON-ის parser-ებს, რომლებიც ცდილობენ string-ის number-ად გარდაქმნას, ან null-ის იდენტიფიცირებას "null"-ის მნიშვნელობისგან.)

Why this matters:

• Prices: CSV-ში 42.99 იქცევა "42.99" JSON-ში – ის string-ია.
• Leading zeros: CSV-ში 00123 იქცევა "00123" – zeros ინახება. (If you later parse this in JavaScript without strict mode, Number("00123") = 123; zeros იკარგება.)
• Boolean: CSV-ში true იქცევა "true" (string). (JSON-ის boolean true ან false იქნება true ან false quote-ების გარეშე.)
• Null: CSV-ში null ან ცარიელი string („“) იქცევა "null" ან "" JSON-ში. (JSON-ის null keyword-ი null-ის სახით გამოიყენება quote-ების გარეშე, მაგრამ CSV-დან ის იქნება "null" string.)

Date handling: CSV-ში 2023-01-15 იქცევა "2023-01-15" – ის string-ია, არა Date object. (თუ JSON-ის parser-ი auto-parse-ს, ის იქნება string.)

Practical example: CSV file: product_code,price; 00123,42.99. JSON: [{"product_code":"00123","price":"42.99"}]. Price is string – 42.99-ის number-ად გარდაქმნა ხელით უნდა მოხდეს.

Delimiter-ის შერჩევა: comma, semicolon, tab

Delimiter-ის არჩევა აქტუალურია CSV-სთვის; JSON-ისა და Excel-ისათვის delimiter-ი ცნობილია. ინსტრუმენტი იძლევა Comma (,), Semicolon (;) ან Tab (\\t). Multiple delimiters (mix) იწვევს parse-ის შეცდომას.

Common pitfalls:

• CSV-ს delimiter-ი, locale-დამოკიდებული: ზოგიერთი CSV export (german Excel) იყენებს semicolon-ს, როდესაც decimal separator-ად მძიმე გამოიყენება. (Example: 19,99 იქნება number, delimiter-ი – semicolon).
• Tab-separated values (TSV): გვხვდება database dumps-ში. ინსტრუმენტი იძლევა Tab-ის არჩევას.
• Embedded commas: CSV-ს ველი "Apple, Inc." quote-ებში delimiter-ს იცავს; without quote (malformed CSV), delimiter-ი parse-ის error-ს იწვევს ("This CSV could not be parsed.").

Error message: "This CSV could not be parsed." – ხდება, როდესაც delimiter-ი აირჩება wrong, ან quoting rules ირღვევა.

Client-side processing: privacy

CSV-to-JSON conversion running entirely in client side (browser). No server upload – file-ის contain sensitive data (e.g., customer list, financial records) stays in local browser. This ensures privacy and security; for team sharing tabular data between non-technical colleague and tech stack, without uploading sensitive information to server.

Error conditions and limits

Error messages (exact wording from fact sheet):

• "This CSV could not be parsed." – quoting errors, inconsistent column counts.
• "This file has no table rows." – file contains header only or no data rows.
• "This table has more than ‹max› rows." – row count exceeds tool limit.
• "This table has more than ‹max› columns." – column count exceeds tool limit.
• "This file is too large. Use a file under ‹max›." – file size exceeds limit.
• "Choose one file first." – user has not selected a file.
• "Choose a CSV, JSON or XLSX file." – file type wrong (e.g., PDF).
• "This conversion is taking too long. Try a smaller file." – timeout (large file with complex quoting).

Row and column limits: Tool applies limit (exact number not given). If file exceeds, error message shows ‹max›.

File size limit: Under ‹max› MB; error message shows exact number.

Empty data rows: "This file has no table rows."

Timeout: If conversion takes too long (e.g., 30+ seconds), error message.

FAQ: 6 real questions

1. რატომ იქცევა ჩემი CSV-ს ნომრები JSON-ში ტექსტად (string-ად)?

CSV-ს ფორმატი ინახავს ყველაფერს ტექსტის სახით; ინსტრუმენტი არ იყენებს number-ის ან boolean-ის ინტერპრეტაციას. თქვენ მოგიწევთ JSON-ის გარდაქმნა post-conversion (e.g., JavaScript-ში Number()-ის გამოყენება), ან CSV-ს export-ის menu-ში "text" format-ის შენარჩუნება.

2. როგორ შევინარჩუნო წამყვანი ნულები (leading zeros) CSV-დან JSON-ში?

თქვენ არ გჭირდებათ special care; ინსტრუმენტი ინახავს leading zeros-ს, რადგან CSV-ს ველი იქცევა string-ად. (Example: 00123 -> "00123"). მაგრამ, if you later JSON-ის parser (e.g., JavaScript-ის JSON.parse) იყენებს auto-typecast-ს, zeros იკარგება; for example, Number("00123") = 123.

3. რატომ მაქვს error 'This CSV could not be parsed'?

უმეტესად, ეს error მიუთითებს wrong delimiter-ზე (e.g., CSV-ს separator is semicolon, but you chose comma) ან quoting error-ზე (e.g., unclosed quote, double quotes instead of escaped quotes). Check CSV file with text editor for quotes and delimiter types.

4. შეიძლება CSV-დან ბუდირებული JSON (nested JSON) მივიღო?

არა. CSV-ს flat table-ს იძლევა only flat array of flat objects. Hierarchical JSON (objects within objects) cannot be created; for nested JSON you need additional rules (like nested CSV columns with dot notation), which this tool does not apply.

5. რა delimiter-ი (comma/semicolon/tab) უნდა ავირჩიო?

Select delimiter based on CSV file's actual separator. If CSV was generated by Excel (locale: English) – comma; Excel (locale: German, French) – semicolon; TSV (tab-separated) – tab. Check file in text editor, e.g., Notepad: if values separated by ;, choose semicolon.

6. რა ხდება, თუ CSV-ში line break-ები (line breaks inside cells) მაქვს?

Line breaks inside quoted fields preserved as \n in JSON string. (Example: CSV "John\nDoe" -> JSON "John\\nDoe".) Unquoted line breaks cause parsing errors ("This CSV could not be parsed."). Check file for unquoted line breaks.