writetimetable

Запись timetable в файл

Описание

пример

writetimetable(TT) пишет расписание TT к файлу разделенного текста запятой. Имя файла является именем переменной рабочей области расписания, добавленного с дополнительным .txt. Если writetimetable не может создать имя файла из входного имени расписания, затем это пишет в файл timetable.txt.

Каждый столбец каждой переменной в TT становится столбцом в выходном файле. Имена переменных TT станьте заголовками столбцов в первой линии файла. writetimetable функционируйте перезаписывает любой существующий файл.

пример

writetimetable(TT,filename) записи к файлу с именем и расширением заданы filename.

writetimetable определяет формат файла на основе заданного расширения. Расширение должно быть одним из следующего:

  • .txt, .dat, или .csv для файлов разделенного текста

  • .xls, .xlsm, или .xlsx для файлов электронной таблицы Excel®

  • .xlsb для файлов электронной таблицы Excel, поддержанных в системах с Excel для Windows®

пример

writetimetable(___,Name,Value) дополнительные опции использования заданы одним или несколькими Name,Value парные аргументы и могут включать любой из входных параметров в предыдущих синтаксисах.

Например, можно задать, записать ли имена переменных как заголовки столбцов в выходном файле.

Примеры

свернуть все

Создайте расписание, запишите его в разделенный от запятой текстовый файл, и затем запишите расписание в другой текстовый файл с различным символом-разделителем.

Задайте расписание в рабочей области с вектором длительности времен строки RowTimes.

RowTimes = seconds(1:5)';
TT = timetable(RowTimes,[98;97.5;97.9;98.1;97.9],[120;111;119;117;116],...
               'VariableNames',{'Reading1','Reading2'})
TT=5×2 timetable
    RowTimes    Reading1    Reading2
    ________    ________    ________

    1 sec           98        120   
    2 sec         97.5        111   
    3 sec         97.9        119   
    4 sec         98.1        117   
    5 sec         97.9        116   

Запишите расписание в файл разделенного текста запятой и отобразите содержимое файла. writetimetable функционируйте выводит текстовый файл под названием TT.txt.

writetimetable(TT)
type 'TT.txt'
RowTimes,Reading1,Reading2
1 sec,98,120
2 sec,97.5,111
3 sec,97.9,119
4 sec,98.1,117
5 sec,97.9,116

Чтобы записать то же расписание в текстовый файл с различным символом-разделителем, используйте 'Delimiter' пара "имя-значение".

writetimetable(TT,'TT_bar.txt','Delimiter','bar')
type 'TT_bar.txt'
RowTimes|Reading1|Reading2
1 sec|98|120
2 sec|97.5|111
3 sec|97.9|119
4 sec|98.1|117
5 sec|97.9|116

Создайте расписание, запишите его в файл электронной таблицы, и затем отобразите содержимое файла.

Задайте расписание в рабочей области с временами строки как datetime вектор.

Y = [2014:2018]'; M = ones(5,1); D = ones(5,1);
RowTimes = datetime(Y,M,D); % Create Row Times
TT = timetable(RowTimes,[98;97.5;97.9;98.1;97.9],[120;111;119;117;116],...
               'VariableNames',{'Reading1','Reading2'})
TT=5×2 timetable
     RowTimes      Reading1    Reading2
    ___________    ________    ________

    01-Jan-2014        98        120   
    01-Jan-2015      97.5        111   
    01-Jan-2016      97.9        119   
    01-Jan-2017      98.1        117   
    01-Jan-2018      97.9        116   

Запишите таблицу в файл электронной таблицы 'TT.xlsx'. По умолчанию, writetimetable функционируйте написал первый рабочий лист в файле. Используйте 'Sheet' пара "имя-значение", чтобы задать рабочий лист, чтобы записать в.

writetimetable(TT,'TT.xlsx','Sheet',2)

Считайте и отобразите содержимое файла.

readtimetable('TT.xlsx','Sheet',2) 
ans=5×2 timetable
          RowTimes          Reading1    Reading2
    ____________________    ________    ________

    01-Jan-2014 00:00:00        98        120   
    01-Jan-2015 00:00:00      97.5        111   
    01-Jan-2016 00:00:00      97.9        119   
    01-Jan-2017 00:00:00      98.1        117   
    01-Jan-2018 00:00:00      97.9        116   

Входные параметры

свернуть все

Введите расписание.

Имя файла, заданное как вектор символов или скаляр строки.

В зависимости от местоположения вы пишете в, filename может взять одну из следующих форм.

Местоположение

Форма

Текущая папка

Чтобы записать в текущую папку, задайте имя файла в filename.

Пример: 'myTextFile.csv'

Другие папки

Чтобы записать в папку, отличающуюся от текущей папки, задайте полное имя или относительный путь в filename.

Пример: 'C:\myFolder\myTextFile.csv'

Пример: 'myFolder\myExcelFile.xlsx'

Удаленное местоположение

Записать в удаленное местоположение, filename должен содержать полный путь файла, заданного как универсальный локатор ресурса (URL) формы:

scheme_name://path_to_file/my_file.ext

На основе вашего удаленного местоположения, scheme_name может быть одно из значений в этой таблице.

Удаленное местоположениеscheme_name
Amazon S3™s3
Устройство хранения данных Windows Azure® Blobwasb, wasbs
HDFS™hdfs

Для получения дополнительной информации смотрите работу с Удаленными данными.

Пример: 's3://bucketname/path_to_file/my_file.xlsx'

  • Если filename включает расширение файла, затем функция записи определяет формат файла из расширения. В противном случае функция записи создает запятую, разделил текстовый файл и добавляет дополнительный .txt. В качестве альтернативы можно задать filename без расширения файла, и затем включают 'FileType' аргументы пары "имя-значение", чтобы указать на тип файла.

  • Если filename не существует, затем функция записи создает файл.

  • Если filename имя файла существующего текста, затем функция записи перезаписывает файл.

  • Если filename имя существующего файла электронной таблицы, затем функция записи пишет данные в заданное местоположение, но не перезаписывает значений вне области значений входных данных.

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'WriteVariableNames',false указывает, что имена переменных не должны быть включены как первая строка выходного файла.

Текст и файлы электронной таблицы

свернуть все

Тип файла, заданного как разделенная запятой пара, состоящая из 'FileType' и вектор символов или строка, содержащая 'text' или 'spreadsheet'.

'FileType' пара "имя-значение" должна использоваться с filename входной параметр. Вы не должны задавать 'FileType' аргумент пары "имя-значение", если filename входной параметр включает стандартное расширение файла. Следующие стандартные расширения файла распознаны функцией записи:

  • .txt, .dat, или .csv для файлов разделенного текста

  • .xls, .xlsm, или .xlsx для файлов электронной таблицы Excel

  • .xlsb для файлов электронной таблицы Excel, поддержанных в системах с Excel для Windows

Пример: 'FileType','spreadsheet'

Типы данных: char | string

Индикатор для записи имен переменных как заголовки столбцов, заданные как разделенная запятой пара, состоящая из 'WriteVariableNames' и любой true, или false.

Индикатор

Поведение

true

Функция записи включает имена переменных как заголовки столбцов выхода. Это поведение по умолчанию.

false

Функция записи не включает имена переменных в выход.

Локаль для записи дат, заданных как разделенная запятой пара, состоящая из 'DateLocale' и вектор символов или скаляр строки. При записи datetime значения к файлу, используйте DateLocale задавать локаль в который writetable должен написать имена месяца и дня недели и сокращения. Вектор символов или строка принимают форму xx_YY, где xx строчный ISO 639-1 двухбуквенный код, указывающий на язык и YY прописная альфа ISO 3166-1 2 кода, указывающие на страну. Для списка общих ценностей для локали смотрите Locale аргумент пары "имя-значение" для datetime функция.

Функция записи игнорирует 'DateLocale' значение параметров каждый раз, когда даты могут быть записаны как отформатированные даты Excel.

Пример: 'DateLocale','ja_JP'

Типы данных: char | string

Текстовые файлы только

свернуть все

Символ разделителя полей, заданный как разделенная запятой пара, состоящая из 'Delimiter' и вектор символов или скаляр строки, содержащий один из следующих спецификаторов.

Спецификатор

Разделитель полей

','

'comma'

Запятая. Это поведение по умолчанию.

' '

'space'

Пробел

'\t'

'tab'

Вкладка

';'

'semi'

Точка с запятой

'|'

'bar'

Вертикальная панель

Можно использовать 'Delimiter' пара "имя-значение" только для файлов разделенного текста.

Пример: 'Delimiter','space'

Типы данных: char | string

Индикатор для записи заключенного в кавычки текста, заданного как разделенная запятой пара, состоящая из 'QuoteStrings' и любой false или true. Если 'QuoteStrings' true, затем функция записи заключает текст в двойные кавычки и заменяет любые символы двойной кавычки, которые появляются как часть того текста с двумя символами двойной кавычки.

Можно использовать 'QuoteStrings' пара "имя-значение" только с файлами разделенного текста.

Схема кодировки символов сопоставлена с файлом, заданным как разделенная запятой пара, состоящая из 'Encoding' и 'system' или схема кодирования стандартного символа называет как одно из значений в этой таблице. Когда вы не задаете кодирования или задаете кодирование как 'system', функция записи использует ваше кодирование системного значения по умолчанию, чтобы записать файл.

'Big5'

'ISO-8859-1'

'windows-874'

'Big5-HKSCS'

'ISO-8859-2'

'windows-949'

'CP949'

'ISO-8859-3'

'windows-1250'

'EUC-KR'

'ISO-8859-4'

'windows-1251'

'EUC-JP'

'ISO-8859-5'

'windows-1252'

'EUC-TW'

'ISO-8859-6'

'windows-1253'

'GB18030'

'ISO-8859-7'

'windows-1254'

'GB2312'

'ISO-8859-8'

'windows-1255'

'GBK'

'ISO-8859-9'

'windows-1256'

'IBM866'

'ISO-8859-11'

'windows-1257'

'KOI8-R'

'ISO-8859-13'

'windows-1258'

'KOI8-U'

'ISO-8859-15'

'US-ASCII'

 

'Macintosh'

'UTF-8'

 

'Shift_JIS'

 

Пример: 'system' использует кодирование системного значения по умолчанию.

Типы данных: char | string

Файлы электронной таблицы только

свернуть все

Рабочий лист, чтобы записать в, заданный как разделенная запятой пара, состоящая из 'Sheet' и вектор символов или скаляр строки, содержащий имя рабочего листа или положительное целое число, указывающее на индекс рабочего листа. Имя рабочего листа не может содержать двоеточие (:). Чтобы определить имена листов в файле электронной таблицы, используйте sheets = sheetnames(filename). Для получения дополнительной информации смотрите sheetnames.

Задайте рабочий лист, чтобы записать в по наименованию или индекс:

  • имя — Если заданное имя листа не существует в файле, то функция записи добавляет новый лист в конце набора рабочего листа.

  • индекс — Если заданный индекс листа является индексом, больше, чем количество рабочих листов, то функция записи добавляет пустые листы до количества рабочих листов в рабочей книге, равняется индексу листа. Функция записи также генерирует предупреждение, указывающее, что она добавила новый рабочий лист.

Можно использовать 'Sheet' пара "имя-значение" только с файлами электронной таблицы.

Пример: 'Sheet',2

Пример: 'Sheet', 'MySheetName'

Типы данных: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Прямоугольный фрагмент рабочего листа, чтобы записать в, заданный как разделенная запятой пара, состоящая из 'Range' и вектор символов или скаляр строки в одной из следующих форм.

Форма значения Range Описание
'Corner1'

Corner1 задает первую ячейку области, чтобы записать. Функция записи пишет данные, запускающиеся в этой ячейке.

Пример: 'Range','D2'

'Corner1:Corner2'

Corner1 и Corner2 два противостоящих угла, которые задают область, чтобы записать. Например, 'D2:H4' представляет прямоугольную область 3 на 5 между этими двумя углами D2 и H4 на рабочем листе. 'Range' аргумент пары "имя-значение" не является чувствительным к регистру, и использует стиль ссылки Excel A1 (см. справку Excel).

Пример: 'Range','D2:H4'

  • Если диапазон, который вы указываете, меньше, чем размер входных данных, то функция записи пишет только подмножество входных данных, которое помещается в область значений.

  • Если диапазон, который вы указываете, больше, чем размер входных данных, то функция записи оставляет остаток от области как есть.

'Range' пара "имя-значение" может только использоваться с файлами Excel.

Пример: 'Range', 'A1:F10'

Типы данных: char | string

Отметьте, чтобы запустить экземпляр Microsoft® Excel для Windows при записи данных об электронной таблице, заданных как разделенная запятой пара, состоящая из 'UseExcel' и любой true, или false.

Можно установить 'UseExcel' параметр к одному из этих значений:

  • true — Функция записи запускает экземпляр Microsoft Excel при записывании файла.

  • false — Функция записи не запускает экземпляр Microsoft Excel при записывании файла. При работе в этом режиме функциональность для записи отличается в поддержку форматов файлов и интерактивных функций, таких как формулы и макросы.

UseExcel

true

false

Поддерживаемые форматы файлов

.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods

.xls, .xlsx, .xlsm, .xltx, .xltm

Поддержка интерактивных функций, таких как формулы и макросы

Да

Нет

Когда запись в файлы электронной таблицы на платформах Windows, если вы хотите запустить экземпляр Microsoft Excel, затем установила 'UseExcel' параметр к true.

Алгоритмы

Существуют некоторые экземпляры где writetimetable функция создает файл, который не представляет входные данные точно. Вы заметите это, когда вы будете использовать readtimetable функционируйте, чтобы считать тот файл. Получившиеся данные не могут иметь того же самого формата или содержимого как исходные данные. Если необходимо сохранить расписание и получить его в более позднее время, чтобы точно совпадать с исходным расписанием, с теми же данными и организацией, то сохранить его как MAT-файл. writetimetable написала неточная таблица в следующих экземплярах:

  • writetimetable выписывает числовые данные с помощью long g формат и категориальные или символьные данные как закрывший кавычки текст.

  • writetimetable выписывает переменные, которые имеют больше чем две размерности как двумерные переменные со свернутыми последующими измерениями.

  • Для переменных со знаком ячейки, writetimetable выписывает переменные по-другому на основе типа данных содержимого в ячейках.

    • Если содержимое ячейки имеет числовой тип данных, текст, логический, категориальный, datetime или длительность, то writetimetable функция выписывает содержимое каждой ячейки как одна строка, в нескольких, разделенных от разделителя полях.

    • В противном случае, writetimetable функция выписывает одно пустое поле.

Смотрите также

| | |

Введенный в R2019a

Для просмотра документации необходимо авторизоваться на сайте