主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

readtimetable

ファ▪▪▪▪ルからの时间表の作成

説明

TT= readtimetable (文件名は,ファ,ルから列方向のデ,タを読み取ることにより时间表を作成します。

readtimetableは,ファaaplル拡張子からファaaplル形式を判定します。

  • 区切りテキストファ电子邮箱ルの場合,. txt.datまたは. csv

  • スプレッドシトファルの場合,xls.xlsb.xlsm.xlsx.xltm.xltxまたは。ods

  • 拡張マ,クアップ言語(xml)の場合,. xml

テキストファルおよびスプレッドシトファルの場合,readtimetableは,ファ▪▪▪ルの列ごとに1▪▪▪の変数をTTに作成し,ファ。XMLファ电子邮箱ルの場合,readtimetableは,时间表変数として検出された要素ノドまたは属性ノドごとに1の変数をTに作成します。変数の名前は要素および属性の名前に対応します。

readtimetableは,表形式デ,タの型がdatetimeまたは持续时间の最初の列を时间表の行時間に設定します。残りの列は时间表の変数になります。

TT= readtimetable (文件名选择は,さらに选择を使用します。

TT= readtimetable (___名称,值は1つ以上の名前と値のペアの引数で指定された追加のオプションを使用して,ファイルから时间表を作成します。名前と値のペアを指定する前に,前述の構文の入力引数のいずれかを使用してください。

デタ特有のンポトオプションを設定するには,选择オブジェクトを使用するか,名前と値のペアを指定できます。选择に加えて名前と値のペアを指定する場合,readtimetableがサポ,トするのは次の名前と値のペアのみです。

  • テキストおよびスプレッドシトのパラメタ- .ReadVariableNamesRowTimesSampleRate步伐开始时间

  • テキストのみのパラメタ-DateLocale编码

  • スプレッドシトのみのパラメタ- .UseExcel

すべて折りたたむ

コンマ区切りのテキストファ▪▪ルからテ▪▪ブルを作成します。

TT =阅读时间表(“outages.csv”);

テ,ブルの概要を表示します。时间表の作成時に行時間のパラメーターを設定しない場合、関数readtimetableはデタOutageTime内の最初のdatetime変数または时间変数を検出し,行時間の変数として指定します。残りの変数は时间表の変数になります。

总结(TT)
RowTimes: OutageTime: 1468x1 datetime值:Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41变量:Region: 1468x1 cell array of character vector Loss: 1468x1 double值:Min 0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double值:Min 0 Median 75765 Max 5.9689e+06 NumMissing 328 RestorationTime: 1468x1 datetime值:Min 2002-02-07 16:50 Median 2010-03-31 10:54 Max 204209-18 23:31 NumMissing 29原因:1468x1 cell array of character vector

テキストファイルのインポートオプションを検出し,変数の型を指定して,データから时间表を作成します。

ファ▪▪ルから▪▪ンポ▪トオプションオブジェクトを作成し,変数オプションを調べます。

opts = detectImportOptions(“outages.csv”);选择。VariableOptions
ans = 1x6异构VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions)数组,属性:Name Type FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule

オプションオブジェクトを変更してデ,タ内の変数の目的のデ,タ型を指定します。変数地区および导致のデタ型を分类に変更します。

选项= setvartype(选项,{“地区”“原因”}, {“分类”“分类”});

readtimetableをオプションオブジェクトと共に使用して,时间表を@ @ンポ@ @トします。次に,时间表の概要を表示します。

TT =阅读时间表(“outages.csv”、选择);总结(TT)
RowTimes: OutageTime: 1468x1 datetime值:Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41变量:Region: 1468x1 categorical值:MidWest 142 NorthEast 557 SouthEast 389 SouthWest 26 West 354 Loss: 1468x1 double值:Min 0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double值:Min 0 Median 75765 Max 5.9689e+06 NumMissing 328 RestorationTime: 1468x1 datetime值:最小时间中位数2010-03-31最大时间最大204209-18 23:31数字失踪29原因:1468x1分类值:攻击294地震2能源紧急188设备故障156火灾25强风暴338雷暴201未知24风95冬季风暴145

コンマ区切りのテキストファイルから表を読み取り,任意の行時間変数である时间表を作成します。

opts = detectImportOptions(“outages.csv”);预览(“outages.csv”选择)
ans =8×6表地区OutageTime RestorationTime造成损失客户  _____________ ________________ ______ __________ ________________ ___________________ {' 西南的}2002-02-01 12:18 458.98 - 1.8202 e + 06 2002-02-01 16:50{“暴风雪”}{“东南”}2003-01-23 00:49 530.14 - 2.1204 e + 05 NaT{“暴风雪”}{“东南”}2003-02-07)21:15 289.4 - 1.4294 e + 05 2003-02-07 08:14{“暴风雪”}{‘西方’}2004-04-06 05:44 434.81 - 3.4037 e + 05 2004-04-06 06:10{“设备故障”}{“中西部”}2002-03-16 06:18 186.442.1275e+05 2002-03-18 23:23{'严重风暴'}{'西部'}2003-06-18 02:49 00 2003-06-18 10:54{'攻击'}{'西部'}2004-06-20 14:39 231.29 NaN 2004-06-20 19:16{'设备故障'}{'西部'}2002-06-06 19:28 311.86 NaN 2002-06-07 00:51{'设备故障'}

変数RestorationTimeを时刻表の行時間変数に指定して,时刻表を作成します。次に,时间表の概要を表示します。

TT =阅读时间表(“outages.csv”“RowTimes”“RestorationTime”);总结(TT)
RowTimes: RestorationTime: 1468x1 datetime值:Min 2002-02-07 16:50 Median 2010-03-31 10:54 Max 204209-18 23:31 NumMissing 29变量:Region: 1468x1 cell array of character vectors OutageTime: 1468x1 datetime值:Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41 Loss: 1468x1 double值:Min 0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double值:Min 0 Median 75765 Max 5.9689e+06 NumMissing 328原因:1468x1 cell array of character vectors

スプレッドシトファルから时间表を作成し,入力デタを書式設定します。たとえば,ファquarterlyFinances1999To2019.csvから时间表を作成し,タイムスタンプの開始日と,各タイムスタンプ間の時間を指定し,データから“$”記号を削除します。

ファereplicationルquarterlyFinances1999To2019.csvのデ,タを时间表として読み取ります。連続する行時間の間の時間の長さを,1999年1月1日から始まる1カレンダー四半期として指定します。“PreserveVariableNames”真正的に設定し,変数名に含まれる空白をそのまま残します。“TrimNonNumeric”真正的に設定し,デ,タの数値の前にある"$"記号を削除します。

TT =阅读时间表(“quarterlyFinances1999To2019.csv”“步伐”calquarters (1)“开始时间”, datetime(1999,1,1),...“PreserveVariableNames”,真的,“TrimNonNumeric”,真正的);

デ,タの概要を表示します。

总结(TT)
行次数:时间:80x1 datetime值:Min 01- 01- 1999年1月-2008年11月- 16- 2018年10月变量:净销售额:80x1 double值:Min 35066中位数1.0407e+05最大1.7684e+05销售成本:80x1 double值:Min 18106中位数48624最大77742毛利率:80x1 double值:Min 14563中位数56719最大99097研发费用:80x1 double值:Min 4904.9中位数24637最大45234管理费用:80x1 double值:Min最小1047.4中位数2015.3最大2811.5总营业费用:80x1倍值:最小5992.5中位数26518最大48045净收入:80x1倍值:最小7634.3中位数28586最大51051总股份:80x1倍值:最小822中位数1820.5最大2710每股收益:80x1倍值:最小6.52中位数15.515最大24.62

入力引数

すべて折りたたむ

読み取るファ@ @ルの名前。文字ベクトルまたは字符串スカラとして指定します。

ファ电子邮箱ルの場所によって,文件名は次のいずれかの形式をとります。

場所

形式

現在のフォルダ,またはmatlab®パス上のフォルダ

ファ@ @ル名を文件名で指定します。

例:“myFile.txt”

フォルダ内のファル

ファルが現在のフォルダまたはmatlabパス上のフォルダにない場合は,文件名に絶対パス名または相対パス名を指定します。

例:“C: \ myFolder \ myFile.xlsx”

例:“dataDir \ myFile.txt”

@ @ @ @ @ @ @ @

ファイルをインターネットの统一资源定位符(URL)として指定する場合,文件名には“http://”または“https://”のプロトコルタ@ @プが含まれていなければなりません。

例:“http://hostname/path_to_file/my_data.csv”

リモ,トの場所

リモトの場所に保存されたファルの場合,文件名は次の形式で指定されたファ@ @ルの絶対パスを含まなければなりません。

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.csv '

  • 文件名にファaapl . exe,にファaapl . exe,ト関数は拡張子からファaapl . exe。それ以外の場合は,名前と値のペアの引数“文件类型”を指定してファ@ @ルの種類を示さなければなりません。

  • 微软®Excel®ソフトウェアがWindows操作系统®システムで,インポート関数は,使用しているExcelのバージョンで認識されるすべてのExcelスプレッドシートファイル形式を読み取ります。

  • システムにExcel for Windowsがない場合,またはMATLAB在线™を使用している場合,UseExcelプロパティがに設定されている状態で動作し,.xls, .xlsx, .xlsm, .xltx和.xltmファ@ @ルのみを読み取ります。

  • 区切りテキストファe.c.ルの場合,e.c.ンポ,e.c.ト関数はファe.c.ル内の空のフィ,e.c.ルドを,(数値変数の場合)または空の文字ベクトル(テキスト変数の場合)のどらかに変換します。テキストファ@ @ルのすべての行には同じ数の区切り記号がなければなりません。@ @ @ @ @ @ @ @ @ @ @ @ @ @。

デ,タ型:字符|字符串

ファ@ @ル@ @ンポ@ @トオプション。関数detectImportOptionsによって作成されたSpreadsheetImportOptionsDelimitedTextImportOptionsFixedWidthImportOptions,またはXMLImportOptionsオブジェクトとして指定します。选择オブジェクトにはデタンポトのプロセスを制御するプロパティが含まれています。各オブジェクトのプロパティの詳細にいては,該当するオブジェクトのペジを参照してください。

ファ@ @ルの種類 出力
スプレッドシトファル SpreadsheetImportOptionsオブジェクト(DataRange,およびVariableNamesプロパティにのみ使用可能)
テキストファ@ @ル DelimitedTextImportOptionsオブジェクト
固定幅テキストファ@ @ル FixedWidthImportOptionsオブジェクト
XMLファescル XMLImportOptionsオブジェクト

名前と値のペアの引数

オプションの名称,值の引数ペアをコンマ区切りで指定します。的名字は引数名で,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を任意の順序で指定できます。

例:“NumHeaderLines”,5は,表形式デ,タの前の最初の5行がヘッダ,行であることを示します。
テキストファ▪▪ルとスプレッドシ▪▪トファ▪▪ル

すべて折りたたむ

ファ@ @ルの種類。“文件类型”“文本”または“表格”で構成されるコンマ区切りのペアとして指定します。

文件名にファ▪▪▪▪ル拡張子が含まれない場合,または次の拡張子以外の場合は,名前と値のペアの引数“文件类型”を指定します。

  • 区切りテキストファ电子邮箱ルの場合,. txt.datまたは. csv

  • スプレッドシトファルの場合,xls.xlsb.xlsm.xlsx.xltm.xltxまたは。ods

例:“文件类型”、“文本”

デ,タ型:字符|字符串

ファ▪▪ルのヘッダ▪▪の行数。“NumHeaderLines”と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、ファイル ヘッダーの行数はインポート関数により自動検出されます。

例:“NumHeaderLines”7

デ,タ型:|

必要な変数の数。“ExpectedNumVariables”と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、変数の数はインポート関数により自動検出されます。

デ,タ型:|

テキストまたはスプレッドシトファルから読み取るデタの部分。“范围”と,次のいずれかの形式をとる文字ベクトル,字符串スカラー,または数値ベクトルで構成されるコンマ区切りのペアとして指定します。

范围の指定方法 説明

開始セル

“细胞”または(行坳)

文字ベクトル,弦スカラー,または2要素数値ベクトルとして,データの開始セルを指定します。

  • ExcelのA1表記法を使用した列の文字および行番号を含む文字ベクトルまたは字符串スカラ。たとえば,A5は列一个と行5が交わる場所にあるセルの識別子です。

  • 開始行と開始列を示す(行坳)形式の2要素数値ベクトル。

開始セルを使用して,インポート関数は,インポートを開始セルで開始し,最後の空の行またはフッター範囲で終了することで,データの範囲を自動的に検出します。

例:的A5または(5 - 1)

四角形の範囲

“Corner1: Corner2”または[r1 c1 r2 c2]

次の四角形の範囲フォ,ムのいずれかを使用して,読み取る範囲を正確に指定します。

  • “Corner1: Corner2”—読み取る領域を定義する2の対角Corner1およびCorner2(ExcelのA1表記法)を使用して範囲を指定します。たとえば,“C2: N15”のようになります。

  • [r1 c1 r2 c2]—開始行、開始列、終了行および終了列を含む4要素数値ベクトルを使用して範囲を指定します。たとえば,[2 3 15 13]のようになります。

。指定された範囲内の空のフィルドは欠損セルとしてンポトされます。

行範囲または列範囲

“第一行:Row2”または“Column1: Column2”

Excelの行番号を使用して,開始行と終了行を示して範囲を指定します。

インポート関数は,指定された行範囲を使用して,最初の空でない列からデータの最後まで読み取ることにより,列の範囲を自動的に検出し,列ごとに1つの変数を作成します。

例:“5:500”

あるいは,Excelの列の文字または数字を使用して開始列と終了列を示して,範囲を指定します。

インポート関数は,指定された列範囲を使用して,最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより,行の範囲を自動的に検出します。

指定された範囲の列数はExpectedNumVariablesプロパティで指定された数と一致しなければなりません。

例:“答:K”

開始行番号

n

正のスカラ行ンデックスを使用して,デタを含む最初の行を指定します。

インポート関数は,指定された行インデックスを使用して,指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより,データの範囲を自動的に検出します。

例:5

Excelの名前付き範囲

“NamedRange”

Excelでは,スプレッドシ,ト内の範囲を表す名前を作成できます。たとえば,スプレッドシ,トの四角形部分を選択して“myTable”という名前を付けることができます。スプレッドシ,ト内にそのような名前付き範囲が存在する場合、インポート関数はその名前を使用して範囲を読み取ることができます。

例:“范围”、“myTable”

指定なしまたは空

指定しない場合,使用範囲は。

例:“范围”,“

メモ:“使用範囲”とは,スプレッドシ,ト内で実際にデ,タが含まれている四角形部分を指します。ンポ,ト関数は,データを含まない先頭と末尾の行と列をすべてトリミングして、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。

デ,タ型:字符|字符串|

“TextType”“字符”または“字符串”で構成されるコンマ区切りのペアとして指定します。

  • “字符”-テキストデタを文字ベクトルとしてmatlabにンポトします。

  • “字符串”-テキストデタをstring配列としてMATLABにンポトします。

例:“TextType”、“生物炭”

“DatetimeType”と,“datetime”“文本”“exceldatenum”のいずれかの値で構成されるコンマ区切りのペアとして指定します。値“exceldatenum”はスプレッドシトファルのみに適用され,テキストファルに対しては有効ではありません。

インポートされる日付と時刻のデータの型
“datetime”

MATLABのdatetimeデタ型

詳細にいては,datetimeを参照してください。

“文本”

“DatetimeType”“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。

  • “TextType”“字符”に設定されている場合,cell配列として返します。

  • “TextType”“字符串”に設定されている場合,stringの配列として返します。

“exceldatenum”

Excelのシリアル日付値

シリアル日付値は,指定された基準日からの日数に等しい単一の数値です。Excelのシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、https://金宝appsupport.microsoft.com/en-us/kb/214330を参照してください。

デ,タ型:字符|字符串

欠損デ,タとして解釈するテキスト。文字ベクトル、字符串スカラ、文字ベクトルのcell配列,または字符串配列として指定します。

例:TreatAsMissing,{“NA”,“TBD”}は,NAまたはTBDのすべての出現を欠損フィ,ルドとして処理するように指示します。

デ,タ型:字符|字符串|细胞

“ReadVariableNames”と,真正的またはのいずれかで構成されるコンマ区切りのペアとして指定される最初の行を変数名として読み取ります。指定しない場合,。

ンジケタ

説明

真正的

読み取る領域の最初の行にテ,ブルの変数名が含まれている場合に使用します。インポート関数は,検出した変数名を使用してTの各列に変数を作成します。

読み取る領域の最初の行にテ,ブルのデ,タが含まれている場合に使用します。インポート関数は,形式“Var1”,…,“VarN”の既定の変数名を作成します。ここでは,Nは変数の数です。

指定なし 指定しない場合,真正的またはを自動的に検出し,それに応じて続行します。

选择に加えてReadVariableNamesの名前と値のペアを指定する場合,。

  • ReadVariableNames真正的に設定されている場合,VariableNamesRangeまたはVariableNamesLineプロパティを使用して,指定されたファ。

  • ReadVariableNamesに設定されている場合,VariableNamesプロパティから変数名を読み取ります。

デ,タ型:逻辑

行時間変数。“RowTimes”および変数名または時間ベクトルで構成されるコンマ区切りのペアとして指定します。

  • 変数名は,datetimeまたは持续时间の値を含む入力表内の任意の変数名を含む文字ベクトルまたは字符串スカラーでなければなりません。変数名で指定される変数は,行の行時間のラベルを提供します。入力表の残りの変数は,时间表の変数になります。

  • 時間ベクトルはdatetimeベクトルまたは持续时间ベクトルでなければなりません。時間ベクトルの要素数は、入力テーブルの行数と等しくなければなりません。時間ベクトルの時間値は、一意であったり、並べ替えられていたり、規則的な値である必要はありません。入力 table のすべての変数は timetable の変数になります。

デ,タ型:字符|字符串|datetime|持续时间

行時間のサンプルレ,ト。“SampleRate”と正の数値スカラ,で構成されるコンマ区切りのペアとして指定します。サンプルレートは,出力时间表の時間ベクトルの1秒あたりのサンプル数(Hz)です。

“SampleRate”を使用して时间表の行時間ベクトルを指定する場合,既定の最初の行時間(開始時間)はゼロ秒です。開始時間をゼロ以外に設定するには,“开始时间”の名前と値のペアを指定します。

デ,タ型:

行時間の間のタ@ @ムステップ。“步伐”および时间スカラーまたはcalendarDurationスカラーで構成されるコンマ区切りのペアとして指定します。“步伐”パラメ,タ,の値は,連続する行時間の間の時間の長さを指定します。ンポ,ト関数は,タイム ステップ値を使用して等間隔の行時間を計算します。

“步伐”を使用して时间表の行時間ベクトルを指定する場合,既定の最初の行時間(開始時間)はゼロ秒です。開始時間をゼロ以外に設定するには,“开始时间”の名前と値のペアを指定します。

“步伐”がカレンダ,期間の値である場合,“开始时间”はdatetime値でなければなりません。

デ,タ型:持续时间|calendarDuration

行時間の開始時間。开始时间と,datetimeスカラーまたは时间スカラーで構成されるコンマ区切りのペアとして指定します。

时间表の時間ベクトルを定義するには,“开始时间”“SampleRate”または“步伐”の名前と値のペアの引数と共に使用します。

開始時間のデ,タ型により,行時間ベクトルのデ,タ型が決まります。

  • 開始時間がdatetime値の場合,时间表の行時間はdatetime値になる。

  • 開始時間がduration値の場合,行時間はdurationになる。

デ,タ型:datetime|持续时间

変数名を保持するかどうかのフラグ。VariableNamingRuleと,“修改”または“保存”のいずれかで構成されるコンマ区切りのペアとして指定します。

  • “修改”-無効な変数名(関数isvarnameで判定)を,有効なmatlab識別子に変換。

  • “保存”——スペースや非ASCII文字を含む変数名など,有効なMATLAB識別子ではない変数名を保持。

R2019b以降,変数名と行名には,スペースや非ASCII文字など任意の文字を含めることができます。また,英字だけでなく任意の文字で始めることができます。変数名と行名は,有効なmatlab識別子(関数isvarnameで判定)である必要はありません。これらの変数名と行名を保持するには,VariableNamingRuleの値を“保存”に設定します。

デ,タ型:字符|字符串

テキストファ@ @ルのみ

すべて折りたたむ

区切りテキストファ▪▪ル内のフィ▪▪ルドの区切り記号。文字ベクトル、字符串スカラ、文字ベクトルのcell配列,または字符串配列として指定します。

例:“分隔符”,“|”

例:“分隔符 ',{';','*'}

デ,タ型:字符|字符串|细胞

空白として扱う文字。1文字以上が含まれる文字ベクトルまたは string スカラーとして指定します。

例:“空白”、“_”

例:“空白”、“? !”

行末の文字。文字ベクトル,弦スカラー,文字ベクトルの细胞配列,または字符串配列として指定します。

例:' LineEnding ', ' \ n '

例:“LineEnding”、“\ r \ n”

例:LineEnding,{‘\ b’,‘:’}

デ,タ型:字符|字符串|细胞

コメントのスタ@ @ル。文字ベクトル、字符串スカラ、文字ベクトルのcell配列,または字符串配列として指定します。

たとえば,パ,セント記号に続く同じ行のテキストを無視するには,CommentStyle“%”に指定します。

例:CommentStyle,{“/ *”}

デ,タ型:字符|字符串|细胞

ファルに関連付けられた文字エンコドスキム。“编码”“系统”で構成されるコンマ区切りのペア,または標準の文字エンコ,ドスキ,ム名として指定します。エンコ,ドを指定しない場合,関数readtimetableは自動文字セット検出を使用して,ファ。

ンポ,トオプションに加えて引数“编码”を指定した場合,関数readtimetable“编码”

例:“编码”,“utf - 8”は,utf-8をエンコ,ドとして使用します。

例:“编码”、“系统”はシステムの既定のエンコ,ドを使用します。

デ,タ型:字符|字符串

テキストファルからの时长デタの出力デタ型。“DurationType”“持续时间”または“文本”のいずれかで構成されるコンマ区切りのペアとして指定します。

インポートされる时间データの型
“持续时间”

MATLABの持续时间デタ型

詳細にいては,持续时间を参照してください。

“文本”

“DurationType”“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。

  • “TextType”“字符”に設定されている場合,インポート関数は时间データを文字ベクトルの细胞配列として返します。

  • “TextType”“字符串”に設定されている場合,インポート関数は时间データを字符串の配列として返します。

デ,タ型:字符|字符串

日付を読み取るロケ,ル。“DateLocale”と,xx_YYの形式の文字ベクトルまたは字符串スカラ,で構成されるコンマ区切りのペアとして指定します。ここで,次のようになります。

  • YYは国を表す大文字のISO 3166-1 alpha-2コ,ド

  • xxは言語を表す小文字2文字のiso 639-1コ,ド

ロケルの一般的な値の一覧にいては,関数datetime语言环境の名前と値のペア引数を参照してください。

% D書式指定子を使用してテキストをdatetime値として読み取る場合,DateLocaleを使用して,。

ンポ,トオプション选择に加えて引数DateLocaleを指定した場合,DateLocale

例:“DateLocale”、“ja_JP”

数値変数内の小数点の区切りを示す文字。文字ベクトルまたは字符串スカラとして指定します。ンポ,ト関数は、DecimalSeparatorの名前と値のペアで指定される文字を使用して,数値の整数部分と小数部分を区別します。

整数デ、タ型に変換すると、小数部分をも、数値は最も近い整数に丸められます。

例:名前と値のペアが“DecimalSeparator”、“,”のように指定される場合,“14159”を数値3.14159として▪▪ンポ▪▪トします。

デ,タ型:字符|字符串

数値変数内の3桁ごとの区切りを示す文字。文字ベクトルまたは字符串スカラとして指定します。3桁ごとの区切り文字は視覚的な区切りとして機能し,数値を3桁ごとにグル,プ化します。ンポ,ト関数は,ThousandsSeparatorの名前と値のペアで指定される文字を使用して,。

例:名前と値のペアが“ThousandsSeparator”、“,”のように指定される場合,“1234000”1234000として▪▪ンポ▪▪トします。

デ,タ型:字符|字符串

非数値文字を数値変数から削除します。逻辑真正的またはとして指定します。

例:名前と値のペアが“TrimNonNumeric”,真的のように指定される場合,“500美元/ -”500として読み取ります。

デ,タ型:逻辑

区切りテキストファ@ @ル内の連続する区切り記号を処理する方法。次の表の値のいずれかとして指定します。

連続する区切り記号のル,ル 動作
“分裂” 連続する区切り記号を複数のフィ,ルドに分割します。
“加入” 複数の区切り記号を結合して1の区切り記号にします。
“错误” エラ,を返し;

デ,タ型:字符|字符串

区切りテキストファ@ @ル内の先頭の区切り記号を管理する方法。次の表の値のいずれかとして指定します。

先頭の区切り記号のル,ル 動作
“保持” 区切り記号を維持します。
“忽略” 区切り記号を無視します。
“错误” エラ,を返し;

区切りテキストファ@ @ル内の末尾の区切り記号を管理する方法。次の表の値のいずれかとして指定します。

先頭の区切り記号のル,ル 動作
“保持” 区切り記号を維持します。
“忽略” 区切り記号を無視します。
“错误” エラ,を返し;
スプレッドシトファルのみ

すべて折りたたむ

読み取り元のシ,ト。空の文字配列、シート名を含む文字ベクトルまたは string スカラー、あるいはシート インデックスを示す正の整数スカラーとして指定します。インポート関数はプロパティに指定された値に基づいて,表に説明されているように動作します。

指定 動作
(既定) 1番目のシトからデタをンポトします。
名前 スプレッドシートファイル内のシートの順序に関係なく,一致する名前のシートからデータをインポートします。
整数 スプレッドシートファイル内のシート名に関係なく,整数で示された位置にあるシートからデータをインポートします。

デ,タ型:字符|字符串||

スプレッドシ,トデ,タを読み取るときに,Microsoft ExcelWindows:の,Windows:ンスタンスを起動するためのフラグ。“UseExcel”と,真正的またはのいずれかで構成されるコンマ区切りのペアとして指定します。

“UseExcel”パラメ,タ,は,次の値のいずれかに設定できます。

  • 真正的——インポート関数は,ファイルを読み取るときにMicrosoft Excelのインスタンスを起動します。

  • ——インポート関数は,ファイルを読み取るときにMicrosoft Excelのインスタンスを起動しません。このモードで動作しているインポート関数の機能では,サポートするファイル形式および式やマクロなどの対話型機能が異なります。

UseExcel

真正的

サポトされているファル形式

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

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

式やマクロなどの対話型機能のサポ,ト

あり

なし

Windowsプラットフォムでスプレッドシトファルを読み取るときにMicrosoft Excelの电子邮箱ンスタンスを起動する場合は,“UseExcel”パラメ,タ,を真正的に設定します。

XMLファescルのみ

すべて折りたたむ

属性接尾辞。“AttributeSuffix”と文字ベクトルまたは字符串スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。この引数は,読み取り関数が入力XMLファイルに含まれる属性に対応するすべての表変数に付加する接尾辞を指定します。“AttributeSuffix”を指定しない場合,読み取り関数は既定で接尾辞“属性”を入力XMLファescルに含まれる属性に対応するすべての変数名に付加します。

例:“AttributeSuffix”、“_att”

属性の▪▪ンポ▪▪ト。“ImportAttributes”と,1真正的)または0)のいずれかで構成されるコンマ区切りのペアとして指定します。を指定すると,読み取り関数は入力ファイル内のXML属性を出力表に変数としてインポートしません。

例:“ImportAttributes”,假的

表行のXMLノド名。“RowNodeName”と文字ベクトルまたは字符串スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。この引数は,出力表の行を区切るXMLノ,ド名を指定します。

例:“RowNodeName”、“XMLNodeName”

表行のXPath式。文字ベクトルまたは字符串スカラとして指定します。読み取り関数は,これを使用して出力表の個々の行を選択します。RowSelectorには有効なXPath 1.0版本の式を指定しなければなりません。

例:“RowSelector”、“RootNode / ChildNode”

表変数のXMLノド名。“VariableNodeNames”と文字ベクトルの细胞配列または字符串配列のいずれかで構成されるコンマ区切りのペアとして指定します。この引数は,読み取り関数が出力表に変数として読み取るXMLノードを識別するために使用するXMLノード名を指定します。

例:VariableNodeNames,{‘XMLNodeName1’,‘XMLNodeName2}

例:“VariableNodeNames”、“XMLNodeName”

例:“VariableNodeNames”,(“XMLNodeName1”、“XMLNodeName2”)

表変数のXPath式。文字ベクトルのcell配列または字符串配列として指定します。読み取り関数は,これを使用して表変数を選択します。VariableSelectorsには有効なXPath 1.0版本の式を指定しなければなりません。

例:VariableSelectors, {' / RootNode / ChildNode '}

例:‘VariableSelectors’,”/ RootNode / ChildNode”

例:“VariableSelectors”,(“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)

表のXMLノド名。“TableNodeName”と文字ベクトルまたは字符串スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。この引数は,読み取り関数が表に読み取る入力構造体のノ,ドを指定します。

例:“TableNodeName”、“节点名的

tableデタのXPath式。文字ベクトルまたは字符串スカラとして指定します。読み取り関数は,これを使用して出力表のデ,タを選択します。TableSelectorには有効なXPath 1.0版本の式を指定しなければなりません。

例:“TableSelector”、“RootNode / ChildNode”

変数の単位のXPath。文字ベクトルまたは字符串スカラとして指定します。読み取り関数は,これを使用して表変数の単位を選択します。VariableUnitsSelectorには有効なXPath 1.0版本の式を指定しなければなりません。

例:“VariableUnitsSelector”、“RootNode / ChildNode”

変数の説明のXPath式。文字ベクトルまたは字符串スカラとして指定します。読み取り関数は,これを使用して表変数の説明を選択します。VariableDescriptionsSelectorには有効なXPath 1.0版本の式を指定しなければなりません。

例:“VariableDescriptionsSelector”、“RootNode / ChildNode”

表の特定の行における繰り返しXMLノドの処理方法。“addcol”“忽略”,または“错误”として指定します。

繰り返しノ,ドの規則

動作

“addcol”

表の変数ヘッダ,の下に繰り返しノ,ド用の列を追加します。“RepeatedNodeRule”の値を“addcol”と指定しても,表に繰り返しノ,ドに対する別個の変数は作成されません。

“忽略”

繰り返しノドはスキップしてンポトします。

“错误” エラメッセジを表示し,ンポト操作を中止します。

例:“RepeatedNodeRule”、“忽略”

登録済みのXML名前空間接頭辞のセット。RegisteredNamespacesと接頭辞の配列で構成されるコンマ区切りのペアとして指定します。読み取り関数は,XMLファaaplルのXPath式を評価する際にこれらの接頭辞を使用します。名前空間接頭辞とそれに関連付けられた URL を N 行 2 列の string 配列として指定します。RegisteredNamespacesは,readstructStructSelectorreadtablereadtimetableVariableSelectorsなど,セレクタ,の名前と値の引数で指定されたXPath式も評価する場合に使用できます。

既定では,読み取り関数はXPathの評価に使用する名前空間接頭辞を自動的に検出して登録しますが,名前と値の引数RegisteredNamespacesを使用して新しい名前空間接頭辞を登録することもできます。新しい名前空間接頭辞の登録は,名前空間URLがあるXMLノードについて,XMLファイルで名前空間接頭辞が宣言されていない場合などに便利です。

たとえば,名前空間接頭辞が含まれていないexample.xmlという名前のXMLファaaplルのXPath式を評価するとします。“RegisteredNamespaces”[" myprefix ", " //www.tatmou.com ")と指定して,接頭辞myprefixをURL//www.tatmou.comに割り当てます。

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",…"RegisteredNamespaces", [" myprefix ", " //www.tatmou.com "])

例:“RegisteredNamespaces”,(“myprefix”、“//www.tatmou.com”)

出力引数

すべて折りたたむ

出力时间表。时间表には、説明、変数の単位、変数名、行時間などのメタデータを保存できます。詳細については、时间表プロパティの節を参照してください。

ヒント

  • RowSelectorVariableSelectorなどのXPathセレクタ,の名前と値の引数では,次のXPath構文がサポ,トされます。

    • ドキュメント内の場所に関係なく,選択するノ,ドに名前が一致するすべてのノ,ドを選択するには," / / myNode”構文を使用します。" / / myNode”を使用すると,XPath式の選択するノ,ドより前の部分を省略できます。

    • ファ▪▪ル内の1ChildNode [nを指定できます。ここで,nは,。たとえば,パス“/ RootNode / ChildNode[2]”は,親がRootNodeである2目のChildNode要素を選択します。

    • 入力XMLファイル内の,ある要素ノードに属する1つの属性の値を読み取るには,属性名の前に@を指定します。たとえば,“/ RootNode / ChildNode [2] / @AttributeName”は,親がRootNodeである2目のChildNode要素に属する属性AttributeNameを選択します。

R2019aで導入