文档

writetimetable

将时间表写入文件

描述

例子

writetimetable (TT写时间表TT到逗号分隔的文本文件。文件名是时间表的工作区变量名,并附加扩展名. txt.如果writetimetable不能从输入时间表名称构造文件名,则写入文件timetable.txt

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

例子

writetimetable (TT文件名写入具有指定的名称和扩展名的文件文件名

writetimetable根据指定的扩展名确定文件格式。扩展名必须是以下其中之一:

  • . txt.dat,或. csv对于带分隔符的文本文件

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

  • .xlsb下载Excel for Windows系统所支持的Exc金宝appel电子表格文件®

例子

writetimetable (___名称,值使用一个或多个指定的其他选项名称,值对参数,并且可以包括以前语法中的任何输入参数。

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

例子

全部折叠

创建一个时间表,将其写入逗号分隔的文本文件,然后将时间表写入另一个具有不同分隔符字符的文本文件。

在工作空间中使用行时间持续向量定义时间表RowTimes

RowTimes = seconds(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 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)类型“TT.txt”
RowTimes,Reading1,Reading2 1秒,98,120 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 sec|98|120 2 sec|97.5|111 3 sec|97.9|119 4 sec|98.1|117 5 sec|97.9|116

创建时间表,将其写入电子表格文件,然后显示文件的内容。

在工作区中定义以行时间为a的时间表datetime向量。

Y = [2014:2018]';M = ones(5,1);D = ones(5,1);RowTimes =日期时间(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 read2 ___________ ________ ________ 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函数写入文件中的第一个工作表。使用“表”名称-值对,用于指定要写入的工作表。

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

读取并显示文件内容。

readtimetable (“TT.xlsx”“表”, 2)
ans =5×2时间表RowTimes Reading1 Reading2 ____________________ ________________ 01- january -2014 00:00:00 98 120 01- january -2015 00:00:00 97.5 111 01- january -2016 00:00:00 97.9 119 01- january -2017 00:00:00 98.1 117 01- january -2018 00:00:00 97.9 116

输入参数

全部折叠

输入时间表。

文件名,指定为字符向量或字符串标量。

根据你要写信的地点,文件名可以变成这些形式之一。

位置

形式

当前文件夹

要写入当前文件夹,请指定文件的名称文件名

例子:“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存储 wasbwasbs
HDFS™ hdfs

有关更多信息,请参见使用远程数据

例子:s3: / / bucketname / path_to_file / my_file.xlsx '

  • 如果文件名包括文件扩展名,然后写入功能从扩展名确定文件格式。否则,写入函数创建一个以逗号分隔的文本文件,并追加扩展名. txt.或者,您可以指定文件名没有文件的扩展名,然后包括“文件类型”名称-值对参数来指示文件类型。

  • 如果文件名不存在,则写入函数创建该文件。

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

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

数据类型:字符|字符串

名称-值对参数

的可选逗号分隔对名称,值参数。名字参数名称和价值对应的值。名字必须出现在引号内。您可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:“WriteVariableNames”,假的指示不应将变量名包括在输出文件的第一行中。

文本和电子表格文件

全部折叠

文件类型,指定为逗号分隔的对,由“文件类型”和字符向量或字符串,包含“文本”“表格”

“文件类型”名称-值对必须与文件名输入参数。不需要指定“文件类型”名称-值对参数文件名Input参数包含一个标准的文件扩展名。写入功能可以识别以下标准文件扩展名:

  • . txt.dat,或. csv对于带分隔符的文本文件

  • xls.xlsm,或.xlsx用于Excel电子表格文件

  • .xlsb下载Excel for Windows系统所支持的Exc金宝appel电子表格文件

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

数据类型:字符|字符串

将变量名写入列标题的指示器,指定为逗号分隔的对,由“WriteVariableNames”,要么真正的,或

指示器

行为

真正的

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

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

用于写入日期的区域设置,指定为逗号分隔的对,由“DateLocale”和字符向量或字符串标量。当你写datetime值添加到文件中,使用DateLocale指定的区域设置writetable应写出月份和星期的名称和缩写。字符向量或字符串采用这种形式xx_YY,在那里xx是一个小写的ISO 639-1两个字母的代码,表示一种语言,和YY是大写的ISO 3166-1 alpha-2代码,表示国家。有关区域设置的通用值的列表,请参见语言环境属性的名称-值对参数datetime函数。

写入函数忽略“DateLocale”当日期可以写成excel格式的日期时,参数值。

例子:“DateLocale”、“ja_JP”

数据类型:字符|字符串

仅限文本文件

全部折叠

字段分隔符字符,指定为逗号分隔的对,由“分隔符”和包含下列说明符之一的字符向量或字符串标量。

说明符

字段分隔符

”、“

“逗号”

逗号。这是默认行为。

' '

“空间”

空间

' \ t '

“标签”

选项卡

“;”

“半”

分号

“|”

“酒吧”

竖线

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

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

数据类型:字符|字符串

写入引用文本的指示符,指定为逗号分隔的对,由“QuoteStrings”,要么真正的.如果“QuoteStrings”真正的,则writing函数将文本括在双引号中,并将作为文本一部分出现的任何双引号字符替换为两个双引号字符。

您可以使用“QuoteStrings”仅对带分隔符的文本文件进行名称-值对。

与文件关联的字符编码方案,指定为逗号分隔的对,由“编码”而且“系统”或标准字符编码方案名称,如此表中的值之一。当您没有指定任何编码或将编码指定为“系统”,写入功能使用系统默认编码写入文件。

“繁体”

“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”

“麦金塔”

“utf - 8”

“Shift_JIS”

例子:“系统”使用系统默认编码。

数据类型:字符|字符串

电子表格文件

全部折叠

要写入的工作表,指定为逗号分隔的对,由“表”字符向量或包含工作表名称的字符串标量或指示工作表索引的正整数。工作表名称不能包含冒号().若要确定电子表格文件中工作表的名称,请使用Sheets = sheetnames(文件名).有关更多信息,请参见sheetnames

按名称或索引指定要写入的工作表:

  • name -如果指定的表名在文件中不存在,则写入函数将在工作表集合的末尾添加一个新表。

  • index -如果指定的工作表索引大于工作表的数量,则写入函数将追加空工作表,直到工作簿中的工作表数量等于工作表索引。写入功能还生成一个警告,表明它已添加了一个新的工作表。

您可以使用“表”仅用于电子表格文件的名称-值对。

例子:“表”2

例子:“表”“MySheetName”

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

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

价值的形式范围 描述
Corner1

Corner1指定要写入的区域的第一个单元格。写入函数从这个单元格开始写入数据。

例子:“范围”、“D2”

Corner1: Corner2

Corner1而且Corner2是两个相对的角,它们定义了要写入的区域。例如,“D2: H4”表示两个角之间的3 × 5矩形区域D2而且H4在工作表上。的“范围”名称-值对参数不区分大小写,并使用Excel A1引用样式(请参阅Excel帮助)。

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

  • 如果指定的范围小于输入数据的大小,则写入函数只写入符合范围的输入数据的子集。

  • 如果指定的范围大于输入数据的大小,则写入函数保持区域的其余部分不变。

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

例子:“范围”A1: F10的

数据类型:字符|字符串

的实例开始的标志微软®Excel写入电子表格数据时,指定为逗号分隔的对,由“UseExcel”,要么真正的,或

您可以设置“UseExcel”参数设置为以下值之一:

  • 真正的—写入时启动Excel实例。

  • —写入时不启动Excel实例。在此模式下操作时,写入功能在对文件格式和交互特性(如公式和宏)的支持方面有所不同。金宝app

UseExcel

真正的

金宝app支持的文件格式

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

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

金宝app支持交互式特性,如公式和宏

是的

没有

在Windows平台上写入电子表格文件时,如果要启动的实例Microsoft Excel,然后设置“UseExcel”参数真正的

算法

有一些例子writetimetable函数创建的文件不完全表示输入数据。的时候,您会注意到这一点readtimetable函数读取该文件。结果数据可能没有与原始数据完全相同的格式或内容。如果您需要保存您的时间表,并在以后检索它,以完全匹配原始时间表,使用相同的数据和组织,然后将其保存为mat文件。writetimetable在以下实例中写入一个不精确的表:

  • writetimetable用写出数值数据长g格式,类别或字符数据为未引用的文本。

  • writetimetable将具有两个以上维度的变量写成二维变量,并将后面的维度折叠起来。

  • 对于单元值变量,writetimetable根据单元格中内容的数据类型写出不同的变量。

    • 如果单元格的内容的数据类型为数值、文本、逻辑、类别、日期时间或持续时间,则writetimetable函数将每个单元格的内容作为单行写入多个分隔符分隔的字段中。

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

在R2019a中引入