主要内容

writetimetable

时间表写入文件

所有的页面崩溃

语法

writetimetable (TT)
writetimetable (TT,文件名)
writetimetable (___、名称、值)

描述

例子

writetimetable (TT)写的时间表TT用逗号分隔的文本文件。文件名的工作空间变量名是时间表,附加的扩展. txt。如果writetimetable从输入时间表不能构建文件名称的名字,然后写入该文件timetable.txt。

每一列的每个变量TT成为一个列在输出文件中。变量的名字TT成为列标题文件的第一行。的writetimetable功能覆盖任何现有的文件。

例子

writetimetable (TT,文件名)写入一个文件中指定的名称和扩展文件名。

writetimetable决定了文件格式根据指定的扩展名。扩展必须是下列之一:

  • . txt,.dat,或. csv分隔的文本文件

  • xls,.xlsm,或.xlsx为Excel®电子表格文件

  • .xlsbExcel电子表格文件支持与Excel为Windows系金宝app统®

  • . xml可扩展标记语言(XML)文件。

例子

writetimetable (___,名称,值)使用指定的一个或多个额外的选项名称,值对参数和可以包括任何输入参数在以前的语法。

例如,您可以指定是否要写输出文件中的变量名作为列标题。

例子

全部折叠

打开生活的脚本

创建一个时间表,把它写逗号分隔的文本文件,然后写时间表到另一个文本文件使用不同的分隔符字符。

在工作区中定义一个时间表与行乘以时间向量RowTimes。

RowTimes =秒(1:5)';TT =时间表(RowTimes, 98; 97.5; 97.9; 98.1; 97.9], [120; 111; 119; 117; 116),…“VariableNames”,{“Reading1”,“Reading2”})
TT =5×2时间表RowTimes Reading1 Reading2 ________说1秒98 120 2秒97.5 111 3秒97.9 97.9 98.1 119 4秒117 5秒116

编写的时间表来一个逗号分隔的文本文件并显示文件内容。的writetimetable函数输出文本文件命名TT.txt。

writetimetable (TT)类型“TT.txt”
RowTimes、Reading1 Reading2 98120秒,2秒,97.5,111 3秒,97.9,119 4秒,98.1,117 5秒,97.9,116

写同样的时间表与不同的分隔符字符,文本文件使用“分隔符”名称-值对。

writetimetable (TT,“TT_bar.txt”,“分隔符”,“酒吧”)类型“TT_bar.txt”
RowTimes | Reading1 | Reading2 1秒| 98 | 120年2秒| 97.5 | 111 3秒4秒| 97.9 | 119 | 117 | 98.1 5秒| 97.9 | 116人
打开生活的脚本

创建一个时间表,把它写一个表格文件,然后显示文件的内容。

定义一个时间表与行乘以在工作区中datetime向量。

Y = [2014:2018] ';M = 1 (5、1);D = 1 (5、1);RowTimes = datetime (Y, M, D);%创建行乘以TT =时间表(RowTimes, 98; 97.5; 97.9; 98.1; 97.9], [120; 111; 119; 117; 116),…“VariableNames”,{“Reading1”,“Reading2”})
TT =5×2时间表RowTimes Reading1 Reading2 ___________说01 - 98年1月- 2014年120 01 - 01 - 1月- 111年1月- 2015 97.5 2016 97.9 119年01 - 01 - 1月- 117年1月- 2017 98.1 2018 97.9 116

写表电子表格文件“TT.xlsx”。默认情况下,writetimetable函数中的第一个工作表文件写道。使用“表”名称-值对将指定工作表。

writetimetable (TT,“TT.xlsx”,“表”,2)

读取和显示文件内容。

readtimetable (“TT.xlsx”,“表”,2)
ans =5×2时间表RowTimes Reading1 Reading2 ____________________说01 - 98年1月- 2014就是120 01 - 111年1月- 2015就是97.5 01 - 119年1月- 2016就是97.9 01 - 117年1月- 2017就是98.1 01 - 116年1月- 2018就是97.9

输入参数

全部折叠

输入时间表。

文件名称,指定为一个特征向量或字符串标量。

根据位置你在写,文件名可以承担其中的一个形式。

位置

形式
当前文件夹

写当前文件夹,指定文件的名称文件名。

例子:“myTextFile.csv”

其他文件夹

写信给一个文件夹不同于当前文件夹,指定完整的或相对路径名文件名。

例子:“C: \ myFolder \ myTextFile.csv”

例子:“myFolder \ myExcelFile.xlsx”

远程位置

写信给一个偏远的位置,文件名必须包含文件的完整路径指定为一个统一资源定位符(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.xlsx '

  • 如果文件名包括文件扩展名,然后写函数决定的文件格式扩展。否则,写函数创建一个逗号分隔的文本文件和附加的扩展. txt。此外,您可以指定文件名没有文件的扩展名,然后包括“文件类型”名称-值对参数来表示文件的类型。

  • 如果文件名不存在,那么写作函数创建该文件。

  • 如果文件名是现有的文本文件的名称,然后写函数覆盖该文件。

  • 如果文件名现有的电子表格文件的名称,那么写函数将数据写到指定的位置,但不覆盖范围以外的任何值的输入数据。

数据类型:字符|字符串

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“WriteVariableNames”,假的表明该变量名不应该作为输出文件的第一行。

文本和电子表格文件

全部折叠

类型的文件,指定为逗号分隔组成的“文件类型”和一个特征向量或字符串包含“文本”或“表格”。

的“文件类型”必须使用的名称-值对文件名输入参数。你不需要指定“文件类型”如果名称-值对的论点文件名输入参数包括一个标准的文件扩展名。以下标准文件扩展名被写作功能:

  • . txt,.dat,或. csv分隔的文本文件

  • xls,.xlsm,或.xlsxExcel电子表格文件

  • .xlsbExcel电子表格文件支持与Excel为Windows系金宝app统

例子:“文件类型”、“表格”

数据类型:字符|字符串

指标编写变量名作为列标题,指定为逗号分隔组成的“WriteVariableNames”,要么真正的或假。

指示器

行为

真正的

写函数包括变量名作为输出的列标题。这是默认的行为。

假

写函数并不包括在输出变量名。

现场写日期,指定为逗号分隔组成的“DateLocale”和一个特征向量或一个字符串标量。当你写datetime值到文件,使用DateLocale指定的场所writetimetable应该写月,一周中的第几天名称和缩写。特征向量或字符串形式xx_YY,在那里xx是小写的ISO 639 - 1两个字母的代码表示一种语言,然后呢YY是一个大写的ISO 3166 - 1α2代码表示一个国家。语言环境的共同价值观,看到语言环境名称-值对的理由datetime函数。

写函数忽略了“DateLocale”参数值时,日期可以写成Excel-formatted日期。

例子:“DateLocale”、“ja_JP”

数据类型:字符|字符串

写作模式,指定为逗号分隔组成的“写模式”和一个特征向量或一个字符串标量。根据文件类型选择一个写模式。

文件类型

写模式
文本文件

  • “覆盖”(默认),覆盖该文件。

  • “添加”——附加数据到文件。

如果指定的文件不存在,那么写函数创建并将数据写入一个新文件。
电子表格文件

  • “原地”(默认),只更新范围的输入数据。写作以外的函数不改变任何数据被输入数据范围。

    • 如果你不指定一个表,然后写函数写入第一个表。

  • “overwritesheet”——明确指定的表和写清除表的输入数据。

    • 如果你不指定一个表,然后写函数清除第一张工作表和写输入数据。

  • “添加”——写函数附加输入数据的底部占领指定表的范围。

    • 如果你不指定一个表,然后写函数附加输入数据占用范围的第一张工作表的底部。

  • “replacefile”——从文件中删除所有其他表,然后清晰和输入数据写入到指定的表。

    • 如果你不指定一个表,那么写函数从文件中删除所有其他表,然后清除,将输入数据写入第一个表。

    • 如果指定的文件不存在,那么写函数创建一个新文件,将输入数据写入第一个表。

  • 当WriteVariableNames被设置为真正的,写函数不支持写模式金宝app“添加”。

  • 为电子表格文件:

    • 当写模式“添加”,写函数不支持的金宝app范围参数。

    • 如果指定的文件不存在,那么写作函数执行相同的操作“replacefile”。

例子:“写模式”,“添加”

数据类型:字符|字符串

文本文件只

全部折叠

字段分隔符字符,指定为逗号分隔组成的“分隔符”和一个特征向量或字符串标量包含其中一个说明符:

说明符

字段分隔符

”、“

“逗号”

逗号。这是默认的行为。

' '

“空间”

空间

' \ t '

“标签”

选项卡

“;”

“半”

分号

“|”

“酒吧”

竖线

您可以使用“分隔符”名称-值对只对分隔的文本文件。

例子:“分隔符”、“空间”

数据类型:字符|字符串

指标写引用文本,指定为“最低”,“所有”,或“没有”。

  • 如果QuoteStrings是“最低”,那么这个函数包含任何变量包含分隔符,行结束,在双引号字符或双引号字符。

  • 如果QuoteStrings是“所有”,那么这个函数包含所有文本、分类、datetime,和持续时间变量在双引号字符。

  • 如果QuoteStrings是“没有”,那么函数不附上变量在双引号字符。

您可以使用QuoteStrings名称-值参数只有分隔的文本文件。

字符编码方案相关文件,指定为逗号分隔组成的“编码”和“系统”或一个标准字符编码方案的名字。当你不指定任何编码,编写函数使用utf - 8编写文件。

例子:“编码”,“utf - 8”使用utf - 8编码。

数据类型:字符|字符串

电子表格文件只

全部折叠

工作表写,指定为逗号分隔组成的“表”和一个特征向量或一个字符串标量包含工作表名称或一个正整数表示工作表索引。工作表名称不能包含冒号(:)。确定的名称表电子表格文件,使用表= sheetnames(文件名)。有关更多信息,请参见sheetnames。

指定工作表写的名字或指数:

  • 名——如果指定表名不存在的文件,然后编写函数的末尾添加一个新表工作表集合。

  • 指数——如果索引指定表索引大于工作表的数量,然后写函数附加空表,直到工作表的工作簿的数量等于表索引。写函数还生成一个警告,表明它已经添加了一个新的工作表。

您可以使用“表”只与电子表格文件名称-值对。

例子:“表”,2

例子:“表”,“MySheetName”

数据类型:字符|字符串|单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

工作表写的矩形部分,指定为逗号分隔组成的“范围”和一个字符向量或字符串标量在下列形式之一。

形成的价值范围 描述
”Corner1”

Corner1指定区域的第一个单元格写。写函数写数据从这个细胞。

例子:“范围”、“D2”
”Corner1: Corner2”

Corner1和Corner2两个对立的角落写定义区域。例如,“D2: H4”代表了三五两角之间的矩形区域D2和H4在工作表上。的“范围”名称-值对参数不区分大小写,并使用Excel A1参考风格(见Excel帮助)。

例子:“范围”、“D2: H4

  • 如果您所指定的范围小于输入数据的大小,然后写函数写输入数据的一个子集,适应范围。

  • 如果您所指定的范围大于输入数据的大小,然后写功能叶的其余部分地区。

的“范围”名称-值对只能使用Excel文件。

例子:“范围”,A1: F10的

数据类型:字符|字符串

标志开始的一个实例微软®Excel对于Windows编写电子表格数据时,指定为逗号分隔组成的“UseExcel”,要么真正的,或假。

你可以设置“UseExcel”参数的值:

  • 真正的——写函数开始Microsoft Excel在编写文件的一个实例。

  • 假——写函数不开始Microsoft Excel在编写文件的一个实例。当操作在这种模式下,写作不同文件格式的支持功能和交互功能,如公式和宏。金宝app

UseExcel

真正的

假
金宝app支持文件格式

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

xls, .xlsx .xlsm、.xltx .xltm

金宝app支持交互式功能,如公式和宏

是的

没有

当编写电子表格文件在Windows平台上,如果你想开始的一个实例Microsoft Excel,然后设置“UseExcel”参数真正的。

自动调整列宽,指定为真正的或假。如果你指定一个值0或假,然后writetimetable不会自动调整列宽,以适应细胞中的数据。

例子:“AutoFitWidth”,0

保护细胞现有表格的格式,指定为真正的或假。如果您指定假,writetimetable不会保持电子表格的单元格格式。格式包括元素,如字体、细胞边界和color-shaded细胞。

当你写datetime数据以电子表格文件,您必须设置“PreserveFormat”和“UseExcel”名称-值对真正的保留现有的单元格格式。如果“UseExcel”被设置为假和“PreserveFormat”被设置为真正的当你写datetime数据文件,writetimetable不会保留现有的单元格格式的文件。

例子:“PreserveFormat”,假

XML文件只

全部折叠

后缀属性,指定为逗号分隔组成的“AttributeSuffix”和一个特征向量或字符串标量变量名称的指示输入表写在输出XML文件作为属性。

例如,对于一个变量名AttName_att在输入表,您可以指定“AttributeSuffix”、“_att”表明“AttName”应写出作为输出XML文件中的属性。

  • 如果你不指定“AttributeSuffix”,writetimetable违约与后缀写变量“属性”输出XML文件中的属性。

  • 如果该属性的值指定为“AttributeSuffix”匹配后缀添加到输入表中的变量名,变量名的后缀会从XML文件的输出。例如,如果您指定“AttributeSuffix”、“_att”输入表中,一个变量命名MyField_att对应于属性命名MyField在XML文件中。

例子:“AttributeSuffix”、“_att”

XML行节点名称,指定为逗号分隔组成的“RowNodeName”和特征向量或字符串标量写函数写的输出XML文件中的节点名对应于输入表中的行。如果你不指定RowNodeName,然后写函数写道“行”随着行输出表中节点的名称。

例子:“TableNodeName”、“RootName”

XML根节点名称,指定为逗号分隔组成的“TableNodeName”和一个特征向量或字符串标量写函数写在输出XML文件作为根节点名称。如果你不指定TableNodeName,然后写函数写道“表”随着输出表中根节点的名称。

例子:“TableNodeName”、“RootName”

限制

  • 设置“PreserveFormat”名称-值对真正的,你必须设置“UseExcel”名称-值对真正的。

算法

有一些例子writetimetable函数创建一个文件,并不代表输入数据准确。你会发现当你使用readtimetable函数来读取该文件。由此产生的数据可能没有完全相同的格式或内容与原始数据。如果您需要保存您的时间表和检索在稍后的时候完全匹配最初的时间表,与相同的数据和组织,然后保存它作为MAT-file。writetimetable写一个不精确的表在下列情况下:

  • writetimetable写出数字数据使用长g格式和分类或字符数据作为非上市文本。

  • writetimetable写出有超过两个维度的变量作为二维变量,落后于维度倒塌。

  • 对于cell-valued的变量,writetimetable写出不同的变量基于内容的数据类型的细胞。

    • 如果单元格的内容是数据类型的数字、文字、逻辑、直言,datetime,或持续时间,那么writetimetable函数写出每个单元格的内容作为一个单独的行,在多个delimiter-separated字段。

    • 否则,writetimetable函数写出一个空字段。

版本历史

介绍了R2019a

另请参阅

|||