readtimetable
基于文件创建时间表
说明
TT = readtimetable(filename)
readtimetable 基于文件的扩展名确定文件格式：
.txt、.dat或.csv（带分隔符的文本文件）.xls、.xlsb、.xlsm、.xlsx、.xltm、.xltx或.ods（电子表格文件）.xml（适用于可扩展标记语言 (XML) 文件）。
对于文本和电子表格文件，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)
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
使用导入选项基于文件创建时间表
检测文本文件的导入选项，指定变量类型，然后基于数据创建时间表。
基于文件创建导入选项对象，并检查变量选项。
opts = detectImportOptions('outages.csv');
opts.VariableOptionsans =
1x6 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)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
基于文件创建时间表并指定行时间
从以逗号分隔的文本文件中读取一个表，并使用您选择的行时间变量创建一个时间表。
创建一个导入选项对象并预览表格数据。
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
从电子表格文件创建时间表并格式化输入数据
从电子表格文件创建一个时间表，并格式化输入数据。例如，从文件 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)
RowTimes:
Time: 80x1 datetime
Values:
Min 01-Jan-1999
Median 16-Nov-2008
Max 01-Oct-2018
Variables:
Net Sales: 80x1 double
Values:
Min 35066
Median 1.0407e+05
Max 1.7684e+05
Cost of Sales: 80x1 double
Values:
Min 18106
Median 48624
Max 77742
Gross Margin: 80x1 double
Values:
Min 14563
Median 56719
Max 99097
Research and Development Expenses: 80x1 double
Values:
Min 4904.9
Median 24637
Max 45234
Administrative Expenses: 80x1 double
Values:
Min 1047.4
Median 2015.3
Max 2811.5
Total Operating Expenses: 80x1 double
Values:
Min 5992.5
Median 26518
Max 48045
Net Income: 80x1 double
Values:
Min 7634.3
Median 28586
Max 51051
Total Shares: 80x1 double
Values:
Min 822
Median 1820.5
Max 2710
Earnings per Share: 80x1 double
Values:
Min 6.52
Median 15.515
Max 24.62
输入参数
输出参量
提示
使用 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
版本历史记录
在 R2019a 中推出
另请参阅
函数
实时编辑器任务
App
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)