readtimetable

Создание объекта Timetable из файла

свернуть все на странице

Синтаксис

TT = readtimetable(filename)

TT = readtimetable(filename,opts)

TT = readtimetable(___,Name,Value)

Описание

пример

TT = readtimetable(filename) создает расписание путем чтения данных в столбцах из файла.

readtimetable определяет формат файла из расширения файла:

.txt, .dat, или .csv для файлов разделенного текста
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, или .ods для файлов электронной таблицы

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

readtimetable устанавливает первый столбец типа datetime или duration в табличных данных, чтобы быть временами строки расписания. Остальные столбцы становятся переменными расписания.

пример

TT = readtimetable(filename,opts) дополнительно использует настройки импорта opts.

пример

TT = readtimetable(___,Name,Value) создает расписание из файла с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Используйте любой из входных параметров от предыдущих синтаксисов прежде, чем задать пары "имя-значение".

Чтобы установить определенные настройки импорта для ваших данных, можно или использовать opts возразите или можно задать пары "имя-значение". Когда вы задаете пары "имя-значение" в дополнение к opts, затем readtimetable поддержки только эти пары "имя-значение":

Текст и параметры электронной таблицы — ReadVariableNamesRowTimes , SampleRate, TimeStepВремя начала
Текст только параметры — DateLocale, Encoding
Электронная таблица только параметры — Sheet, UseExcel

Примеры

свернуть все

Создание объекта Timetable из текстового файла

Скрипт Open Live Script

Составьте таблицу из разделенного от запятой текстового файла.

TT = readtimetable('outages.csv');

Отобразите сводные данные таблицы. При создании расписания, если вы не задаете параметров в течение времен строки, затем readtimetable функция обнаруживает и определяет первый datetime или переменную длительности в данных, OutageTime, как переменная времен строки. Остающиеся переменные становятся переменными расписания.

summary(TT)

RowTimes:

    OutageTime: 1468x1 datetime
        Values:
            Min         01-Feb-2002 12:18:00 
            Median      18-Mar-2010 21:05:30 
            Max         15-Jan-2014 02:41:00 

Variables:

    Region: 1468x1 cell array of character vectors

    Loss: 1468x1 double

        Values:

            Min             0       
            Median          180.26  
            Max             23418   
            NumMissing      604     

    Customers: 1468x1 double

        Values:

            Min             0           
            Median          75765       
            Max             5.9689e+06  
            NumMissing      328         

    RestorationTime: 1468x1 datetime

        Values:

            Min             07-Feb-2002 16:50:00  
            Median          31-Mar-2010 10:54:00  
            Max             18-Sep-2042 23:31:00  
            NumMissing      29                    

    Cause: 1468x1 cell array of character vectors

Создание объекта Timetable из Файла с помощью Настроек импорта

Скрипт Open Live Script

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

Создайте объект настроек импорта из файла и исследуйте параметры переменной.

opts = detectImportOptions('outages.csv');
opts.VariableOptions

ans = 
  1x6 heterogeneous VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions) array with properties:

    Name
    Type
    FillValue
    TreatAsMissing
    QuoteRule
    Prefixes
    Suffixes
    EmptyFieldRule

Измените объект опций задать желаемые типы данных для переменных в данных. Измените типы данных для переменных Region и Cause к категориальному.

opts = setvartype(opts,{'Region','Cause'},{'categorical','categorical'});

Используйте readtimetable наряду с опциями возражают, чтобы импортировать расписание. Затем отобразите сводные данные расписания.

TT = readtimetable('outages.csv',opts);
summary(TT)

RowTimes:

    OutageTime: 1468x1 datetime
        Values:
            Min         01-Feb-2002 12:18:00 
            Median      18-Mar-2010 21:05:30 
            Max         15-Jan-2014 02:41:00 

Variables:

    Region: 1468x1 categorical

        Values:

            MidWest        142   
            NorthEast      557   
            SouthEast      389   
            SouthWest       26   
            West           354   

    Loss: 1468x1 double

        Values:

            Min             0       
            Median          180.26  
            Max             23418   
            NumMissing      604     

    Customers: 1468x1 double

        Values:

            Min             0           
            Median          75765       
            Max             5.9689e+06  
            NumMissing      328         

    RestorationTime: 1468x1 datetime

        Values:

            Min             07-Feb-2002 16:50:00  
            Median          31-Mar-2010 10:54:00  
            Max             18-Sep-2042 23:31:00  
            NumMissing      29                    

    Cause: 1468x1 categorical

        Values:

            attack                294  
            earthquake              2  
            energy emergency      188  
            equipment fault       156  
            fire                   25  
            severe storm          338  
            thunder storm         201  
            unknown                24  
            wind                   95  
            winter storm          145

Создание объекта Timetable из файла и задает времена строки

Скрипт Open Live Script

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

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

opts = detectImportOptions('outages.csv');
preview('outages.csv',opts)

ans=8×6 table
       Region             OutageTime          Loss     Customers       RestorationTime              Cause       
    _____________    ____________________    ______    __________    ____________________    ___________________

    {'SouthWest'}    01-Feb-2002 12:18:00    458.98    1.8202e+06    07-Feb-2002 16:50:00    {'winter storm'   }
    {'SouthEast'}    23-Jan-2003 00:49:00    530.14    2.1204e+05                     NaT    {'winter storm'   }
    {'SouthEast'}    07-Feb-2003 21:15:00     289.4    1.4294e+05    17-Feb-2003 08:14:00    {'winter storm'   }
    {'West'     }    06-Apr-2004 05:44:00    434.81    3.4037e+05    06-Apr-2004 06:10:00    {'equipment fault'}
    {'MidWest'  }    16-Mar-2002 06:18:00    186.44    2.1275e+05    18-Mar-2002 23:23:00    {'severe storm'   }
    {'West'     }    18-Jun-2003 02:49:00         0             0    18-Jun-2003 10:54:00    {'attack'         }
    {'West'     }    20-Jun-2004 14:39:00    231.29           NaN    20-Jun-2004 19:16:00    {'equipment fault'}
    {'West'     }    06-Jun-2002 19:28:00    311.86           NaN    07-Jun-2002 00:51:00    {'equipment fault'}

Создайте расписание путем определения RestorationTime переменная, чтобы быть переменной времен строки для расписания. Затем отобразите сводные данные расписания.

TT = readtimetable('outages.csv','RowTimes','RestorationTime');
summary(TT)

RowTimes:

    RestorationTime: 1468x1 datetime
        Values:
            Min             07-Feb-2002 16:50:00 
            Median          31-Mar-2010 10:54:00 
            Max             18-Sep-2042 23:31:00 
            NumMissing      29                   

Variables:

    Region: 1468x1 cell array of character vectors

    OutageTime: 1468x1 datetime

        Values:

            Min       01-Feb-2002 12:18:00
            Median    18-Mar-2010 21:05:30
            Max       15-Jan-2014 02:41:00

    Loss: 1468x1 double

        Values:

            Min             0       
            Median          180.26  
            Max             23418   
            NumMissing      604     

    Customers: 1468x1 double

        Values:

            Min             0           
            Median          75765       
            Max             5.9689e+06  
            NumMissing      328         

    Cause: 1468x1 cell array of character vectors

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

свернуть все

`filename` — Имя файла, чтобы читать
вектор символов | представляет скаляр в виде строки

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

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

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

Форма

Текущая папка или папка на пути MATLAB^®

Задайте имя файла в filename.

Пример: 'myFile.txt'

Файл в папке

Если файл не находится в текущей папке или в папке на пути MATLAB, то задайте полное имя или относительный путь в filename.

Пример: 'C:\myFolder\myFile.xlsx'

Пример: 'dataDir\myFile.txt'

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

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

scheme_name://path_to_file/my_file.ext

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

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

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

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

Если filename включает расширение файла, затем функция импорта определяет формат файла из расширения. В противном случае необходимо задать 'FileType' аргументы пары "имя-значение", чтобы указать на тип файла.
В системах Windows^® с программным обеспечением Microsoft^® Excel^® функция импорта читает любой формат файла электронной таблицы Excel, распознанный вашей версией Excel.
Если ваша система не имеет Excel для Windows или если вы используете MATLAB Online™, функция импорта действует с UseExcel набор свойств к false, и чтения только .xls, .xlsx, .xlsm, .xltx, and .xltm файлы.
Для файлов разделенного текста функция импорта преобразует пустые поля в файле к любому NaN (для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все линии в текстовом файле должны иметь то же количество разделителей. Функция импорта игнорирует незначительный пробел в файле.

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

`opts` — Настройки импорта файла
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`

Настройки импорта файла, заданные как SpreadsheetImportOptionsDelimitedTextImportOptions, или FixedWidthImportOptions объект создается detectImportOptions функция. opts объект содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах каждого объекта смотрите соответствующую объектную страницу.

Тип файлов	Вывод
Файлы электронной таблицы	`SpreadsheetImportOptions` объект
Текстовые файлы	`DelimitedTextImportOptions` объект
Текстовые файлы фиксированной ширины	`FixedWidthImportOptions` объект

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

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

Пример: 'NumHeaderLines',5 указывает, что первые пять линий, которые предшествуют табличным данным, являются линиями заголовка.

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

свернуть все

`'FileType'` — Тип файла
`'text'` | `'spreadsheet'`

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

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

.txt, .dat, или .csv для файлов разделенного текста
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, или .ods для файлов электронной таблицы

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

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

`'NumHeaderLines'` — Количество линий заголовка
положительное целое число

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

Пример: 'NumHeaderLines',7

Типы данных: single | double

`'ExpectedNumVariables'` — Ожидаемое количество переменных
положительное целое число

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

Типы данных: single | double

`'Range'` — Фрагмент данных, чтобы читать
вектор символов | представляет скаляр в виде строки | числовой вектор

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

Способы задать Range Описание

Способы задать `Range`	Описание
Запуск ячейки `'Cell'` или `[row col]`	Задайте стартовую ячейку для данных как вектор символов или представьте в виде строки скаляр или два элемента числовой вектор. Вектор символов или скаляр строки, содержащий букву столбца и номер строки с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Два элемента числовой вектор формы `[row col]` указание на стартовую строку и столбец. Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. Пример: `'A5'` или `[5 1]`
Прямоугольная область значений `'Corner1:Corner2'` или `[r1 c1 r2 c2]`	Укажите точный диапазон, чтобы считать использование прямоугольной области значений в одной из следующих форм. `'Corner1:Corner2'` — Укажите диапазон с помощью `Corner1` и `Corner2` которые являются двумя противостоящими углами, которые задают область, чтобы читать в Excel `A1` обозначение. Например, `'C2:N15'`. `[r1 c1 r2 c2]` — Укажите диапазон с помощью четырех элементов числовой вектор, содержащий начинать-строку, начальный столбец, строку конца и столбец конца. Например, `[2 3 15 13]`. Функция импорта только считывает данные, содержавшиеся в заданной области. Любые пустые поля в заданной области импортируются как недостающие ячейки.
Область значений строки или область значений столбца `'Row1:Row2'` или `'Column1:Column2'`	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Используя указанный диапазон строки, функция импорта автоматически обнаруживает степень столбца путем чтения из первого непустого столбца в конец данных и создает одну переменную для каждого столбца. Пример: `'5:500'` В качестве альтернативы укажите диапазон путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа. Используя указанный диапазон столбца, функция импорта автоматически обнаруживает степень строки путем чтения из первой непустой строки в конец данных или области значений нижнего колонтитула. Количество столбцов в заданной области должно совпадать с номером, заданным в `ExpectedNumVariables` свойство. Пример: `'A:K'`
Запуск номера строки `n`	Задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины. Используя заданный индекс строки, функция импорта автоматически обнаруживает степень данных путем чтения из заданной первой строки в конец данных или области значений нижнего колонтитула. Пример 5
Именованная область значений Excel `'NamedRange'`	В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее `'myTable'`. Если такие именованные области значений существуют в электронной таблице, то функция импорта может считать ту область значений с помощью своего имени. Пример: `'Range','myTable'`
Незаданный или пустой `''`	Если незаданный, функция импорта автоматически обнаруживает используемую область значений. Пример: `'Range',''` Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений путем обрезки любого продвижения и запаздывающих строк и столбцов, которые не содержат данные. Текст, который является только пробелом, рассматривается данными и получен в используемой области значений.

Запуск ячейки

'Cell' или [row col]

Задайте стартовую ячейку для данных как вектор символов или представьте в виде строки скаляр или два элемента числовой вектор.

Вектор символов или скаляр строки, содержащий букву столбца и номер строки с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.
Два элемента числовой вектор формы [row col] указание на стартовую строку и столбец.

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

Пример: 'A5' или [5 1]

Прямоугольная область значений

'Corner1:Corner2' или [r1 c1 r2 c2]

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

'Corner1:Corner2' — Укажите диапазон с помощью Corner1 и Corner2 которые являются двумя противостоящими углами, которые задают область, чтобы читать в Excel A1 обозначение. Например, 'C2:N15'.
[r1 c1 r2 c2] — Укажите диапазон с помощью четырех элементов числовой вектор, содержащий начинать-строку, начальный столбец, строку конца и столбец конца. Например, [2 3 15 13].

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

Область значений строки или область значений столбца

'Row1:Row2' или 'Column1:Column2'

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

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

Пример: '5:500'

В качестве альтернативы укажите диапазон путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа.

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

Количество столбцов в заданной области должно совпадать с номером, заданным в ExpectedNumVariables свойство.

Пример: 'A:K'

Запуск номера строки

n

Задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины.

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

Пример 5

Именованная область значений Excel

'NamedRange'

В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее 'myTable'. Если такие именованные области значений существуют в электронной таблице, то функция импорта может считать ту область значений с помощью своего имени.

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

Незаданный или пустой

''

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

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

Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений путем обрезки любого продвижения и запаздывающих строк и столбцов, которые не содержат данные. Текст, который является только пробелом, рассматривается данными и получен в используемой области значений.

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

`'TextType'` — Введите для данных об импортируемом тексте
`'char'` (значение по умолчанию) | `'string'`

Введите для данных об импортируемом тексте, заданных как разделенная запятой пара, состоящая из 'TextType' и любой 'char' или 'string'.

'char' — Импортируйте текстовые данные в MATLAB как векторы символов.
'string' — Импортируйте текстовые данные в MATLAB как строковые массивы.

Пример: 'TextType','char'

`'DatetimeType'` — Введите для импортированных данных о дате и времени
`'datetime'` (значение по умолчанию) | `'text'` | `'exceldatenum'` Файлы электронной таблицы только

Введите для импортированных данных о дате и времени, заданных как разделенная запятой пара, состоящая из 'DatetimeType' и одно из этих значений: 'datetime'Текст, или 'exceldatenum'. Значение 'exceldatenum' применимо только для файлов электронной таблицы и не допустим для текстовых файлов.

Значение Введите для импортированных данных о дате и времени

Значение	Введите для импортированных данных о дате и времени
`'datetime'`	MATLAB `datetime` тип данных Для получения дополнительной информации смотрите `datetime`.
`'text'`	Если `'DatetimeType'` задан как `'text'`, затем тип для импортированных данных о дате и времени зависит от значения, заданного в `'TextType'` параметр: Если `'TextType'` установлен в `'char'`, затем функция импорта возвращает даты как массив ячеек из символьных векторов. Если `'TextType'` установлен в `'string'`, затем функция импорта возвращает даты как массив строк.
`'exceldatenum'`	Excel последовательные числа даты Последовательный номер даты является одним номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите `https://support.microsoft.com/en-us/kb/214330`.

'datetime'

MATLAB datetime тип данных

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

'text'

Если 'DatetimeType' задан как 'text', затем тип для импортированных данных о дате и времени зависит от значения, заданного в 'TextType' параметр:

Если 'TextType' установлен в 'char', затем функция импорта возвращает даты как массив ячеек из символьных векторов.
Если 'TextType' установлен в 'string', затем функция импорта возвращает даты как массив строк.

'exceldatenum'

Excel последовательные числа даты

Последовательный номер даты является одним номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите https://support.microsoft.com/en-us/kb/214330.

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

`'TreatAsMissing'` — Текст, чтобы интерпретировать как недостающие данные
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

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

Пример: 'TreatAsMissing',{'NA','TBD'} дает функции импорта команду обрабатывать любое вхождение NA или TBD как недостающие поля.

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

`'ReadVariableNames'` — Считайте первую строку как имена переменных
`true` | `false`

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

Индикатор	Описание
`true`	Используйте, когда первая строка области, которая будет читать, будет содержать имена переменных для таблицы. Функция импорта создает переменную, с обнаруженным именем переменной, для каждого столбца в `T`.
`false`	Используйте, когда первая строка области, которая будет читать, будет содержать данные в таблице. Функция импорта создает имена переменных по умолчанию формы `'Var1',...,'VarN'`, где `N` количество переменных.
Незаданный	Когда оставлено незаданный, функция импорта автоматически обнаруживает `true` или `false` и доходы соответственно.

Когда вы задаете ReadVariableNames пара "имя-значение" в дополнение к opts, затем импорт функционирует доходы можно следующим образом.

Если ReadVariableNames установлен в true, затем функция импорта читает имена переменных из заданного файла при помощи VariableNamesRange или VariableNamesLine свойство объекта настроек импорта.
Если ReadVariableNames установлен в false, затем функция импорта читает имена переменных из VariableNames свойство объекта настроек импорта.

Типы данных: логический

`'RowTimes'` — Переменная времен строки
имя переменной | временной вектор

Переменная времен строки, заданная как разделенная запятой пара, состоящая из 'RowTimes' и имя переменной или временной вектор.

Имя переменной должно быть вектором символов или представить в виде строки скаляр, содержащий имя любой переменной во входной таблице, которая содержит datetime или duration значения. Переменная, заданная именем переменной, обеспечивает метки времени строки для строк. Остающиеся переменные входной таблицы становятся переменными расписания.
Временным вектором должен быть datetime вектор или duration вектор. Число элементов временного вектора должно равняться количеству строк входной таблицы. Временные стоимости во временном векторе не должны быть уникальными, не отсортированы, или регулярными. Все переменные входной таблицы становятся переменными расписания.

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

`'SampleRate'` — Частота дискретизации в течение времен строки
положительный числовой скаляр

Частота дискретизации в течение времен строки, заданных как разделенная запятой пара, состоящая из 'SampleRate' и положительный числовой скаляр. Частота дискретизации является количеством выборок в секунду (Гц) временного вектора выходного расписания.

Когда вы используете 'SampleRate' чтобы задать временной вектор строки расписания, первое время строки по умолчанию (время начала) является нулевой секундой. Чтобы установить время начала кроме нуля, задайте the'StartTime' пара "имя-значение".

Типы данных: double

`'TimeStep'` — Временной шаг между временами строки
скаляр длительности | calendarDuration скаляр

Временной шаг между временами строки, заданными как разделенная запятой пара, состоящая из 'TimeStep' и скаляр длительности или calendarDuration скаляр. Значение 'TimeStep' параметр задает отрезок времени между временами строки подряд. Функция импорта использует значение временного шага, чтобы вычислить расположенные с равными интервалами времена строки.

Когда вы используете 'TimeStep' чтобы задать временной вектор строки расписания, первое время строки по умолчанию (время начала) является нулевой секундой. Чтобы установить время начала кроме нуля, задайте 'StartTime' пара "имя-значение".

Если 'TimeStep' календарное значение длительности, затем 'StartTime' должно быть значение datetime.

Типы данных: duration | calendarDuration

`'StartTime'` — Время начала времен строки
скаляр datetime | скаляр длительности

Время начала времен строки, заданных как разделенная запятой пара, состоящая из StartTime и скаляр datetime или скаляр длительности.

Чтобы задать временной вектор для расписания, используйте 'StartTime' с любым 'SampleRate' или 'TimeStep' аргументы в виде пар имя-значение.

Тип данных времени начала, диктует тип данных временного вектора строки.

Если время начала является значением datetime, то времена строки расписания являются значениями datetime.
Если время начала является значением длительности, то времена строки являются длительностью.

Типы данных: datetime | duration

`'PreserveVariableNames'` — Отметьте, чтобы сохранить имена переменных
`false` (значение по умолчанию) | `true`

Отметьте, чтобы сохранить имена переменных, заданные как разделенная запятой пара, состоящая из PreserveVariableNames и любой true, или false.

true — Сохраните имена переменных, которые не являются допустимыми идентификаторами MATLAB, такими как имена переменных, которые включают символы non-ASCII и пробелы.
false — Преобразуйте недопустимые имена переменных (как определено isvarname функция) к допустимым идентификаторам MATLAB.

Начиная в R2019b, имена переменных и имена строки могут включать любые символы, включая символы non-ASCII и пробелы. Кроме того, они могут запустить с любых символов, не только обозначает буквами. Переменная и имена строки не должны быть допустимыми идентификаторами MATLAB (как определено isvarname функция. Чтобы сохранить эти имена переменных и имена строки, установите PreserveVariableNames к true.

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

свернуть все

`'Delimiter'` — Символы разделителя полей
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

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

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

Пример: 'Delimiter',{';','*'}

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

`'Whitespace'` — Символы, чтобы обработать как пробел
вектор символов | представляет скаляр в виде строки

Символы, чтобы обработать как пробел, заданный как вектор символов или представить в виде строки скаляр, содержащий один или несколько символов.

Пример: 'Whitespace',' _'

Пример: 'Whitespace','?!.,'

`'LineEnding'` — Символы конца линии
`{'\n','\r','\r\n'}` (значение по умолчанию) | вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

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

Пример: 'LineEnding','\n'

Пример: 'LineEnding','\r\n'

Пример: 'LineEnding',{'\b',':'}

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

`'CommentStyle'` — Стиль комментариев
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

Стиль комментариев, заданных как вектор символов, представляет в виде строки скаляр, массив ячеек из символьных векторов или массив строк.

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

Пример: 'CommentStyle',{'/*'}

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

`'Encoding'` — Схема кодировки символов
`'system'` | `'UTF-8'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

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

`'Big5'`	`'ISO-8859-1'`	`'windows-847'`
`'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'`

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

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

`'DurationType'` — Тип выходных данных данных о длительности
`'duration'` (значение по умолчанию) | `'text'`

Тип выходных данных данных о длительности из текстовых файлов, заданных как разделенная запятой пара, состоящая из 'DurationType' и любой 'duration' или 'text'.

Значение Введите для импортированных данных о длительности

Значение	Введите для импортированных данных о длительности
`'duration'`	MATLAB `duration` тип данных Для получения дополнительной информации смотрите `duration`.
`'text'`	Если `'DurationType'` задан как `'text'`, затем тип для импортированных данных о длительности зависит от значения, заданного в `'TextType'` параметр: Если `'TextType'` установлен в `'char'`, затем функция импорта возвращает данные о длительности как массив ячеек из символьных векторов. Если `'TextType'` установлен в `'string'`, затем функция импорта возвращает данные о длительности как массив строк.

'duration'

MATLAB duration тип данных

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

'text'

Если 'DurationType' задан как 'text', затем тип для импортированных данных о длительности зависит от значения, заданного в 'TextType' параметр:

Если 'TextType' установлен в 'char', затем функция импорта возвращает данные о длительности как массив ячеек из символьных векторов.
Если 'TextType' установлен в 'string', затем функция импорта возвращает данные о длительности как массив строк.

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

`'DateLocale'` — Локаль для чтения дат
вектор символов | представляет скаляр в виде строки

Локаль для чтения дат, заданных как разделенная запятой пара, состоящая из 'DateLocale' и вектор символов или скаляр строки формы xx_YY, где:

YY прописная альфа ISO 3166-1 2 кода, указывающие на страну.
xx строчный ISO 639-1 двухбуквенный код, указывающий на язык.

Для списка общих ценностей для локали смотрите Locale аргумент пары "имя-значение" для datetime функция.

При использовании %D спецификатор формата, чтобы считать текст как datetime значения, используйте DateLocale задавать локаль, в которой функция импорта должна интерпретировать имена месяца и дня недели и сокращения.

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

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

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | представляет скаляр в виде строки

Символы, указывающие на десятичный разделитель в числовых переменных, заданных как вектор символов или скаляр строки. Функция импорта использует символы, заданные в DecimalSeparator пара "имя-значение", чтобы отличить целую часть номера от десятичной части.

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

Пример: Если пара "имя-значение" задана как 'DecimalSeparator',',', затем функция импорта импортирует текст "3,14159" как номер 3.14159.

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

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | представляет скаляр в виде строки

Символы, которые указывают на тысячи группировки в числовых переменных, заданных как вектор символов, или представляют скаляр в виде строки. Тысячи группирующихся символов действуют как визуальные диафрагмы, группируя номер в каждых трех значениях места. Функция импорта использует символы, заданные в ThousandsSeparator пара "имя-значение", чтобы интерпретировать импортируемые числа.

Пример: Если пара "имя-значение" задана как 'ThousandsSeparator',',', затем функция импорта импортирует текст "1,234,000" как 1234000.

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

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

Удалите нечисловые символы из числовой переменной, заданной как логический true или false.

Пример: Если пара "имя-значение" задана как 'TrimNonNumeric',true, затем функция импорта читает '$500/-' как 500.

Типы данных: логический

`'ConsecutiveDelimitersRule'` — Процедура, чтобы обработать последовательные разделители
`'split'` | `'join'` | `'error'`

Процедура, чтобы обработать последовательные разделители в файле разделенного текста, заданном как одно из значений в этой таблице.

ConsecutiveDelimitersRule	Поведение
`'split'`	Разделите последовательные разделители в несколько полей.
`'join'`	Соедините разделители в один разделитель.
`'error'`	Возвратите ошибку и прервите операцию импорта.

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

`'LeadingDelimitersRule'` — Процедура, чтобы управлять ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

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

LeadingDelimitersRule	Поведение
`'keep'`	Сохраните разделитель.
`'ignore'`	Проигнорируйте разделитель.
`'error'`	Возвратите ошибку и прервите операцию импорта.

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

свернуть все

`'Sheet'` — Покройте, чтобы читать из
`''` пустой символьный массив (значение по умолчанию) | вектор символов | представляет скаляр в виде строки | положительное скалярное целое число

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

Спецификация	Поведение
`''` (значение по умолчанию)	Импортируйте данные от первого листа.
Имя	Импортируйте данные с соответствующего имени листа, независимо от порядка листов в файле электронной таблицы.
Целое число	Импортируйте данные от листа в положении, обозначенном целым числом, независимо от имен листа в файле электронной таблицы.

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

`'UseExcel'` — Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows
`false` (значение по умолчанию) | `true`

Отметьте, чтобы запустить экземпляр 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.

Выходные аргументы

свернуть все

`TT` — Выведите расписание
расписание

Выведите расписание. Расписание может сохранить метаданные, такие как описания, переменные модули, имена переменных, и времена строки. Для получения дополнительной информации смотрите разделы Свойств timetable.

Документация

readtimetable

Синтаксис

Описание

Примеры

Создание объекта Timetable из текстового файла

Создание объекта Timetable из Файла с помощью Настроек импорта

Создание объекта Timetable из файла и задает времена строки

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

filename — Имя файла, чтобы читать вектор символов | представляет скаляр в виде строки

opts — Настройки импорта файла SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions

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

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

'FileType' — Тип файла 'text' | 'spreadsheet'

'NumHeaderLines' — Количество линий заголовка положительное целое число

'ExpectedNumVariables' — Ожидаемое количество переменных положительное целое число

'Range' — Фрагмент данных, чтобы читать вектор символов | представляет скаляр в виде строки | числовой вектор

'TextType' — Введите для данных об импортируемом тексте 'char' (значение по умолчанию) | 'string'

'DatetimeType' — Введите для импортированных данных о дате и времени 'datetime' (значение по умолчанию) | 'text' | 'exceldatenum' Файлы электронной таблицы только

'ReadVariableNames' — Считайте первую строку как имена переменных true | false

'RowTimes' — Переменная времен строки имя переменной | временной вектор

'SampleRate' — Частота дискретизации в течение времен строки положительный числовой скаляр

'TimeStep' — Временной шаг между временами строки скаляр длительности | calendarDuration скаляр

'StartTime' — Время начала времен строки скаляр datetime | скаляр длительности

'PreserveVariableNames' — Отметьте, чтобы сохранить имена переменных false (значение по умолчанию) | true

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

'Delimiter' — Символы разделителя полей вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

'Whitespace' — Символы, чтобы обработать как пробел вектор символов | представляет скаляр в виде строки

'CommentStyle' — Стиль комментариев вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

'Encoding' — Схема кодировки символов 'system' | 'UTF-8' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

'DurationType' — Тип выходных данных данных о длительности 'duration' (значение по умолчанию) | 'text'

'DateLocale' — Локаль для чтения дат вектор символов | представляет скаляр в виде строки

'DecimalSeparator' — Символы, указывающие на десятичный разделитель вектор символов | представляет скаляр в виде строки

'ThousandsSeparator' — Символы, которые указывают на тысячи группировки вектор символов | представляет скаляр в виде строки

'TrimNonNumeric' — Удалите нечисловые символы false (значение по умолчанию) | true

'ConsecutiveDelimitersRule' — Процедура, чтобы обработать последовательные разделители 'split' | 'join' | 'error'

'LeadingDelimitersRule' — Процедура, чтобы управлять ведущими разделителями 'keep' | 'ignore' | 'error'

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

'UseExcel' — Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows false (значение по умолчанию) | true

Выходные аргументы

TT — Выведите расписание расписание

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

Введенный в R2019a

Документация MATLAB

Поддержка

`filename` — Имя файла, чтобы читать
вектор символов | представляет скаляр в виде строки

`opts` — Настройки импорта файла
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`

`'FileType'` — Тип файла
`'text'` | `'spreadsheet'`

`'NumHeaderLines'` — Количество линий заголовка
положительное целое число

`'ExpectedNumVariables'` — Ожидаемое количество переменных
положительное целое число

`'Range'` — Фрагмент данных, чтобы читать
вектор символов | представляет скаляр в виде строки | числовой вектор

`'TextType'` — Введите для данных об импортируемом тексте
`'char'` (значение по умолчанию) | `'string'`

`'DatetimeType'` — Введите для импортированных данных о дате и времени
`'datetime'` (значение по умолчанию) | `'text'` | `'exceldatenum'` Файлы электронной таблицы только

`'ReadVariableNames'` — Считайте первую строку как имена переменных
`true` | `false`

`'RowTimes'` — Переменная времен строки
имя переменной | временной вектор

`'SampleRate'` — Частота дискретизации в течение времен строки
положительный числовой скаляр

`'TimeStep'` — Временной шаг между временами строки
скаляр длительности | calendarDuration скаляр

`'StartTime'` — Время начала времен строки
скаляр datetime | скаляр длительности

`'PreserveVariableNames'` — Отметьте, чтобы сохранить имена переменных
`false` (значение по умолчанию) | `true`

`'Delimiter'` — Символы разделителя полей
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

`'Whitespace'` — Символы, чтобы обработать как пробел
вектор символов | представляет скаляр в виде строки

`'CommentStyle'` — Стиль комментариев
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

`'Encoding'` — Схема кодировки символов
`'system'` | `'UTF-8'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

`'DurationType'` — Тип выходных данных данных о длительности
`'duration'` (значение по умолчанию) | `'text'`

`'DateLocale'` — Локаль для чтения дат
вектор символов | представляет скаляр в виде строки

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | представляет скаляр в виде строки

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | представляет скаляр в виде строки

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

`'ConsecutiveDelimitersRule'` — Процедура, чтобы обработать последовательные разделители
`'split'` | `'join'` | `'error'`

`'LeadingDelimitersRule'` — Процедура, чтобы управлять ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

`'UseExcel'` — Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows
`false` (значение по умолчанию) | `true`

`TT` — Выведите расписание
расписание