readtimetable
基于文件创建时间表
说明
TT = readtimetable(filename)
readtimetable 基于文件的扩展名确定文件格式：
.txt、.dat或.csv（带分隔符的文本文件）.xls、.xlsb、.xlsm、.xlsx、.xltm、.xltx或.ods（电子表格文件）.xml（可扩展标记语言 (XML) 文件）.zip、.gz或.tar（压缩和存档文件）
对于文本和电子表格文件，readtimetable 为该文件中的每列在 TT 中创建一个变量并从文件的第一行中读取变量名称。对于 XML 文件，readtimetable 在 T 中为检测为时间表变量的每个元素或属性节点创建一个变量。变量名称对应于元素和属性名称。
readtimetable 将表格数据中 datetime 或 duration 类型的第一列设置为时间表的行时间。其余列成为时间表的变量。
TT = readtimetable(___,Name,Value)
要为数据设置特定的导入选项，您可以使用 opts 对象，也可以指定名称-值对组。当您指定除 opts 之外的名称-值对组时，readtimetable 仅支持下列名称-值对组：
文本和电子表格参数 -
ReadVariableNames、RowTimes、SampleRate、TimeStep、StartTime仅文本参数 -
DateLocale、Encoding仅电子表格参数 -
Sheet、UseExcel
示例
基于逗号分隔的文本文件创建表。
TT = readtimetable('outages.csv');显示表的摘要。创建时间表时，如果没有为行时间指定任何参数，则 readtimetable 函数会检测并指定数据中的第一个日期时间变量或持续时间变量 OutageTime 作为行时间变量。其余变量成为时间表的变量。
summary(TT)
TT: 1468×5 timetable
Row Times:
OutageTime: datetime
Variables:
Region: cell array of character vectors
Loss: double
Customers: double
RestorationTime: datetime
Cause: cell array of character vectors
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
OutageTime 0 2002-02-01 12:18 2010-03-18 21:05 2014-01-15 02:41 2009-07-03 12:49 27450:31:25
Region 0
Loss 604 0 180.2583 2.3418e+04 563.8885 1.8793e+03
Customers 328 0 7.5765e+04 5.9689e+06 1.6693e+05 3.6873e+05
RestorationTime 29 2002-02-07 16:50 2010-03-31 10:54 2042-09-18 23:31 2009-07-27 15:47 28592:30:37
Cause 0
检测文本文件的导入选项，指定变量类型，然后基于数据创建时间表。
基于文件创建导入选项对象，并检查变量选项。
opts = detectImportOptions('outages.csv');
opts.VariableOptionsans =
1×6 heterogeneous VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions) array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
修改选项对象，为数据中的变量指定所需的数据类型。将变量 Region 和 Cause 的数据类型更改为 categorical。
opts = setvartype(opts,{'Region','Cause'},{'categorical','categorical'});使用 readtimetable 以及选项对象导入时间表。然后显示该时间表的汇总。
TT = readtimetable('outages.csv',opts);
summary(TT)TT: 1468×5 timetable
Row Times:
OutageTime: datetime
Variables:
Region: categorical (5 categories)
Loss: double
Customers: double
RestorationTime: datetime
Cause: categorical (10 categories)
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
OutageTime 0 2002-02-01 12:18 2010-03-18 21:05 2014-01-15 02:41 2009-07-03 12:49 27450:31:25
Region 0
Loss 604 0 180.2583 2.3418e+04 563.8885 1.8793e+03
Customers 328 0 7.5765e+04 5.9689e+06 1.6693e+05 3.6873e+05
RestorationTime 29 2002-02-07 16:50 2010-03-31 10:54 2042-09-18 23:31 2009-07-27 15:47 28592:30:37
Cause 0
从以逗号分隔的文本文件中读取一个表，并使用您选择的行时间变量创建一个时间表。
创建一个导入选项对象并预览表格数据。
opts = detectImportOptions('outages.csv'); preview('outages.csv',opts)
ans=8×6 table
Region OutageTime Loss Customers RestorationTime Cause
_____________ ________________ ______ __________ ________________ ___________________
{'SouthWest'} 2002-02-01 12:18 458.98 1.8202e+06 2002-02-07 16:50 {'winter storm' }
{'SouthEast'} 2003-01-23 00:49 530.14 2.1204e+05 NaT {'winter storm' }
{'SouthEast'} 2003-02-07 21:15 289.4 1.4294e+05 2003-02-17 08:14 {'winter storm' }
{'West' } 2004-04-06 05:44 434.81 3.4037e+05 2004-04-06 06:10 {'equipment fault'}
{'MidWest' } 2002-03-16 06:18 186.44 2.1275e+05 2002-03-18 23:23 {'severe storm' }
{'West' } 2003-06-18 02:49 0 0 2003-06-18 10:54 {'attack' }
{'West' } 2004-06-20 14:39 231.29 NaN 2004-06-20 19:16 {'equipment fault'}
{'West' } 2002-06-06 19:28 311.86 NaN 2002-06-07 00:51 {'equipment fault'}
通过将 RestorationTime 变量指定为时间表的行时间变量来创建一个时间表。然后，显示该时间表的汇总。
TT = readtimetable('outages.csv','RowTimes','RestorationTime'); summary(TT)
TT: 1468×5 timetable
Row Times:
RestorationTime: datetime
Variables:
Region: cell array of character vectors
OutageTime: datetime
Loss: double
Customers: double
Cause: cell array of character vectors
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
RestorationTime 29 2002-02-07 16:50 2010-03-31 10:54 2042-09-18 23:31 2009-07-27 15:47 28592:30:37
Region 0
OutageTime 0 2002-02-01 12:18 2010-03-18 21:05 2014-01-15 02:41 2009-07-03 12:49 27450:31:25
Loss 604 0 180.2583 2.3418e+04 563.8885 1.8793e+03
Customers 328 0 7.5765e+04 5.9689e+06 1.6693e+05 3.6873e+05
Cause 0
从电子表格文件创建一个时间表，并格式化输入数据。例如，从文件 quarterlyFinances1999To2019.csv 创建一个时间表，指定时间戳的开始日期和每个时间戳之间的时间，并从数据中删除“$”符号。
以时间表形式读取文件 quarterlyFinances1999To2019.csv 中的数据。将连续行时间之间的时间长度指定为一个日历季度，从 1999 年 1 月 1 日开始。将 'VariableNamingRule' 设置为 preserve 以保留变量名称中的空白，并将 'TrimNonNumeric' 设置为 true 以删除数据中数值前的“$”符号。
TT = readtimetable("quarterlyFinances1999To2019.csv","TimeStep", calquarters(1),"StartTime", datetime(1999, 1, 1),... "VariableNamingRule", "preserve", "TrimNonNumeric", true);
显示数据的摘要。
summary(TT)
TT: 80×9 timetable
Row Times:
Time: datetime
Variables:
Net Sales: double
Cost of Sales: double
Gross Margin: double
Research and Development Expenses: double
Administrative Expenses: double
Total Operating Expenses: double
Net Income: double
Total Shares: double
Earnings per Share: double
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
Time 0 01-Jan-1999 16-Nov-2008 01-Oct-2018 15-Nov-2008 04:30:00 50925:56:30
NetSales 0 3.5066e+04 1.0407e+05 1.7684e+05 1.0377e+05 3.8034e+04
CostOfSales 0 1.8106e+04 4.8624e+04 7.7742e+04 4.8410e+04 1.7219e+04
GrossMargin 0 1.4563e+04 5.6719e+04 9.9097e+04 5.5361e+04 2.1060e+04
ResearchAndDevelopmentExpenses 0 4.9049e+03 2.4637e+04 4.5234e+04 2.4761e+04 1.1524e+04
AdministrativeExpenses 0 1.0474e+03 2.0153e+03 2.8115e+03 1.9745e+03 497.5852
TotalOperatingExpenses 0 5.9925e+03 2.6518e+04 4.8045e+04 2.6736e+04 1.1987e+04
NetIncome 0 7.6343e+03 2.8586e+04 5.1051e+04 2.8625e+04 9.8181e+03
TotalShares 0 822 1.8205e+03 2710 1.8013e+03 496.7446
EarningsPerShare 0 6.5200 15.5150 24.6200 15.7921 3.2653
输入参数
名称-值参数
输出参量
提示
使用 XPath 选择器指定要导入 XML 输入文档的哪些元素。例如，假设您要导入 XML 文件
myFile.xml，该文件具有以下结构：下表提供 XPath 选择器名称-值参量（例如<data> <table category="ones"> <var>1</var> <var>2</var> </table> <table category="tens"> <var>10</var> <var>20</var> </table> </data>VariableSelectors或TableSelector）支持的 XPath 语法。选取操作 语法 示例 结果 选择其名称与您要选择的节点匹配的每个节点，而无论它在文档中的位置如何。 在名称前加两个正斜杠 ( //) 前缀。data = readtable('myFile.xml', 'VariableSelectors', '//var')
data = 4×1 table var ___ 1 2 10 20读取属于元素节点的属性的值。 在属性前加 at 符号 ( @) 前缀。data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')
data = 2×1 table categoryAttribute _________________ "ones" "tens"在一组节点中选择一个特定节点。 在方括号 ( []) 中提供要选择的节点的索引。data = readtable('myFile.xml', 'TableSelector', '//table[1]')
data = 2×1 table var ___ 1 2指定运算的优先级。 在要首先计算的表达式前后添加圆括号。 data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')
data = 2×1 table var ___ 1 10data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')
data = table var ___ 1
