Фильтр CSV принимает строку параметра, содержащую от пяти до пятнадцати токенов, разделённых запятыми. Токены от 6 и до 15 указывать необязательно.
Импорт из UTF-8, язык: немецкий, разделитель ячеек: запятая, разделитель текста: «"», Поля в кавычках как текст. В CSV-файле имеются столбцы в формате «дата, число, число, число»:
soffice --infilter="Text - txt - csv (StarCalc):44,34,76,1,1/5/2/1/3/1/4/1,1031,true,true" test.csv
Экспорт в Windows-1252, разделитель полей: запятая, разделитель текста: кавычка, сохранять содержимое ячеек как на экране:
soffice --convert-to "csv:Text - txt - csv (StarCalc):44,34,ANSI,1,,0,false,true,true" --outdir=/home/user test.ods
|
Расположение токена |
Определение |
Значение и пример использования токена |
|---|---|---|
|
1 |
Разделитель полей |
Разделитель (разделители) полей в виде значений в ASCII-коде. Несколько значений разделяются знаком косой черты («/»). То есть, если значения разделены точкой с запятой и горизонтальной табуляцией, токен будет выглядеть как 59/9. Чтобы несколько идущих подряд разделителей обрабатывались как один, добавьте к токену '/MRG'. Если файл содержит поля фиксированной ширины, используйте 'FIX'. Пример: 44 (,) |
|
2 |
Разделитель текста |
Разделитель текста в виде значения в ASCII-коде, например, 34 для двойной кавычки, а 39 для одинарной. Пример: 34 ("). |
|
3 |
Кодировка |
Код используемой в файле кодировки символов согласно описанию в таблице ниже. Пример: 0 (Системная). |
|
4 |
Читать со строки. Импорт CSV |
N: читать со строки. Пример: 3 (читать с третьей строки). |
|
5 |
Коды формата ячеек для каждого столбца Импорт CSV |
Последовательность пар «столбец/код формата», где код формата приведен в таблице ниже. Пример: «1/5/2/1/3/1/4/1». Если используются разделители значений, то такой токен имеет вид «столбец/формат[/столбец/формат/…]», где «столбец» — это номер столбца, а 1 обозначает самый левый столбец. Коды форматов подробно описаны ниже. Если первый токен имеет значение FIX, то он имеет вид «старт/формат[/старт/формат/…]», где старт — это номер первого символа для этого поля, а 0 обозначает самый левый символ в строке. Описание форматов представлено ниже. |
|
6 |
Идентификатор языка |
Строка в десятичной нотации. Этот токен соответствует списку «Язык» в пользовательском интерфейсе импорта CSV. Если значение равно 0 или опущено, то используется идентификатор языка интерфейса пользователя. Идентификатор языка основан на идентификаторах языков Microsoft. |
|
7 |
Поля в кавычках как текст |
Строка содержит значение false или true. Значение по умолчанию: false. Этот токен соответствует флажку «Поля в кавычках как текст». |
|
8 |
Распознавать особые числа |
Импорт: Строка содержит false или true. Значение по умолчанию: false. Этот токен соответствует флажку «Распознавать особые числа». Экспорт: Строка содержит false или true. Значение по умолчанию: true. Этот токен не используется в пользовательском интерфейсе. Если значение true, числовые ячейки сохраняются как числа. Если значение false, числовые ячейки сохраняются как текст с текстовыми разделителями. |
|
9 |
Сохранять содержимое ячеек как на экране Экспорт CSV |
Строка содержит false или true. Значение по умолчанию:true. Этот токен соответствует флажку «Сохранять содержимое ячеек как на экране». |
|
10 |
Экспорт формул ячеек Экспорт CSV |
Строка содержит false или true. Значение по умолчанию: false. Экспорт формул ячеек. |
|
11 |
Обрезать пробелы Импорт CSV |
Строка содержит false или true. Значение по умолчанию: false. Обрезать пробелы. Удаляет начальные и конечные пробелы при чтении файла. |
|
12 |
Экспортировать листы Экспорт CSV |
Экспортировать весь документ или указанный лист в отдельные листы в виде файлов .csv.
|
|
13 |
Импортировать в виде формул Импорт CSV |
Строка содержит false или true. Значение по умолчанию: false. Определяет, нужно ли вычислять формулы, начинающиеся с символа знака равно «=», или импортировать их как текстовые данные. При значении true формулы вычисляются. При значении false формулы вставляются как текст. Если параметр опущен (полностью отсутствует), значение по умолчанию true, чтобы сохранить поведение как в строке параметров старых версий, в которых этого токена не существует. Если параметр присутствует, но пуст (либо содержит любое другое значение, отличное от true), то используется значение по умолчанию false. |
|
14 |
Включать метку порядка байтов (BOM) Экспорт CSV |
Строка содержит значение false или true. Значение по умолчанию: false. Если значение true, то экспорт не включает метку порядка байтов (BOM). Если значение false, то экспорт включает BOM. Если параметр опущен (полностью отсутствует), то используется значение по умолчанию false, чтобы сохранить поведение как в строке параметров старых версий, в которых данный токен отсутствует. Если параметр присутствует, но пуст (либо содержит любое другое значение, отличное от true), то используется значение по умолчанию false. Определяется автоматически при импорте. |
|
15 |
Распознавать экспоненциальную запись Импорт CSV |
Строка содержит false или true. Значение по умолчанию: true. Если значение true, выполняется проверка на наличие числа экспоненциальной нотации в ячейке, содержащей «E» или «e». Если значение false, проверка на наличие числа экспоненциальной нотации проводится не будет. Токен может быть false, только когда токен 8 (Распознавать особые числа) тоже имеет значение false. Если параметр опущен, то используется значение по умолчанию true, чтобы сохранить поведение как в строке параметров старых версий, в которых этого токена не существует. |
Импорт и экспорт CSV поддерживает параметр разделителя поля в виде sep= и "sep=". При чтении документа CSV разделитель берётся из одного начального поля sep= или "sep=", если это единственное содержимое данной строки.
При чтении CSV-файла запись в кавычках сохраняется как содержимое ячейки (без кавычек). При этом отображается sep=|, когда символ «|» является разделителем в первой строке. В записи без кавычек разделитель удаляется, так как текущем контексте он является настоящим разделителем полей. В таком случае первая строка будет содержать sep=.
При записи CSV-файла текущее содержимое единственной верхней левой ячейки (например, sep=|) адаптируется к текущему разделителю, принимая запись в кавычках "sep=|" (если кавычки или разделители текста не были опущены, и символ «|» является разделителем), и всегда использует ASCII-символ двойных кавычек ".
Если строка, содержащая sep=|, не должна импортироваться в виде данных, не забудьте установить значение 2 для параметра Читать со строки в диалоговом окне. Обратите внимание, что эта строка не сохраняется при повторном сохранении.
sep=|
"LETTER"|"ANIMAL"
"a"|"aardvark"
"b"|"bear"
"c"|"cow"
|
Значение |
Код |
|---|---|
Стандартный |
1 |
Текст |
2 |
ММ/ДД/ГГ |
3 |
ДД/ММ/ГГ |
4 |
ГГ/ММ/ДД |
5 |
- |
6 |
- |
7 |
- |
8 |
Игнорировать поле (не импортировать) |
9 |
US-English |
10 |