このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
readvars
ファイルからの変数の読み取り
構文
説明
[Var1,Var2,...,VarN] = readvars(
は、ファイルから列方向のデータを読み取ることにより変数を作成します。ファイルに filename
)N
列のデータが含まれている場合、readvars
は N
個の変数 Var1,Var2,...,VarN
を返します。
readvars
は、ファイル拡張子からファイル形式を判定します。
区切りテキスト ファイルの場合、
.txt
、.dat
または.csv
スプレッドシート ファイルの場合、
.xls
、.xlsb
、.xlsm
、.xlsx
、.xltm
,.xltx
または.ods
[Var1,Var2,...,VarN] = readvars(___,
は、1 つ以上の名前と値のペアの引数で指定された追加のオプションを使用して、ファイルから変数を作成します。名前と値のペアを指定する前に、前述の構文の入力引数のいずれかを使用してください。Name,Value
)
データ特有のインポート オプションを設定するには、opts
オブジェクトを使用するか、名前と値のペアを指定できます。opts
に加えて名前と値のペアを指定する場合、readvars
がサポートするのは次の名前と値のペアのみです。
テキスト ファイル —
DateLocale
、Encoding
スプレッドシート ファイル —
Sheet
、UseExcel
例
テキスト ファイルからの変数の読み取り
テキスト ファイル内の表形式データから列を別個の変数としてインポートします。最初に、テキスト ファイル outages.csv
の内容をプレビューし、列を読み取ります。
outages.csv
内のデータをプレビューします。ファイルには 6
個の変数があります。
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'}
最初の 3 つの列をワークスペース内の別個の変数としてインポートします。
[Region,OutageTime,Loss] = readvars('outages.csv'); whos Region OutageTime Loss
Name Size Bytes Class Attributes Loss 1468x1 11744 double OutageTime 1468x1 23520 datetime Region 1468x1 174988 cell
スプレッドシート ファイルからの変数の読み取り
スプレッドシート ファイルから列をワークスペース内の別個の変数としてインポートします。最初に、テキスト ファイル outages.csv
の内容をプレビューし、列を別個の変数として読み取ります。
patients.xls
内のデータをプレビューします。ファイルには 10
個の変数があります。
opts = detectImportOptions('patients.xls'); preview('patients.xls',opts)
ans=8×10 table
LastName Gender Age Location Height Weight Smoker Systolic Diastolic SelfAssessedHealthStatus
____________ __________ ___ _____________________________ ______ ______ ______ ________ _________ ________________________
{'Smith' } {'Male' } 38 {'County General Hospital' } 71 176 true 124 93 {'Excellent'}
{'Johnson' } {'Male' } 43 {'VA Hospital' } 69 163 false 109 77 {'Fair' }
{'Williams'} {'Female'} 38 {'St. Mary's Medical Center'} 64 131 false 125 83 {'Good' }
{'Jones' } {'Female'} 40 {'VA Hospital' } 67 133 false 117 75 {'Fair' }
{'Brown' } {'Female'} 49 {'County General Hospital' } 64 119 false 122 80 {'Good' }
{'Davis' } {'Female'} 46 {'St. Mary's Medical Center'} 68 142 false 121 70 {'Good' }
{'Miller' } {'Female'} 33 {'VA Hospital' } 64 142 true 130 88 {'Good' }
{'Wilson' } {'Male' } 40 {'VA Hospital' } 68 180 false 115 82 {'Good' }
最初の 3 つの列をワークスペース内の別個の変数としてインポートします。
[LastName,Gender,Age] = readvars('patients.xls'); whos LastName Gender Age
Name Size Bytes Class Attributes Age 100x1 800 double Gender 100x1 11412 cell LastName 100x1 11616 cell
インポート オプションを使用した特定のシートおよび範囲からの変数の読み取り
スプレッドシート ファイルのデータをプレビューし、特定のシートおよび範囲からデータの列を別個の変数としてインポートします。
スプレッドシート ファイル airlinesmall_subset.xlsx
には 1996 年から 2008 年のデータが複数のワークシートに分かれて含まれています。各ワークシートには、指定の年のデータがあります。ファイル airlinesmall_subset.xlsx
のデータをプレビューします。関数 preview
は、既定で最初のワークシートのデータを表示します。
opts = detectImportOptions('airlinesmall_subset.xlsx'); preview('airlinesmall_subset.xlsx',opts)
ans=8×29 table
Year Month DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime AirTime ArrDelay DepDelay Origin Dest Distance TaxiIn TaxiOut Cancelled CancellationCode Diverted CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay
____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ _______ _________ ________________ ________ ____________ ____________ __________ _____________ _________________
1996 1 18 4 2117 2120 2305 2259 {'HP'} 415 {'N637AW'} 108 99 85 6 -3 {'COS'} {'PHX'} 551 5 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 12 5 1252 1245 1511 1500 {'HP'} 610 {'N905AW'} 79 75 58 11 7 {'LAX'} {'PHX'} 370 3 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 16 2 1441 1445 1708 1721 {'HP'} 211 {'N165AW'} 87 96 74 -13 -4 {'RNO'} {'PHX'} 601 4 9 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 1 1 2258 2300 2336 2335 {'HP'} 1245 {'N183AW'} 38 35 20 1 -2 {'TUS'} {'PHX'} 110 6 12 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 4 4 1814 1814 1901 1910 {'US'} 683 {'N963VJ'} 47 56 34 -9 0 {'DTW'} {'PIT'} 201 6 7 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 31 3 1822 1820 1934 1925 {'US'} 757 {'N912VJ'} 72 65 52 9 2 {'PHL'} {'PIT'} 267 6 14 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 18 4 729 730 841 843 {'US'} 1564 {'N941VJ'} 72 73 58 -2 -1 {'DCA'} {'PVD'} 357 3 11 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 26 5 1704 1705 1829 1839 {'NW'} 1538 {'N960N' } 85 94 69 -10 -1 {'DTW'} {'RIC'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
opts
オブジェクトの値を設定し、'2007'
という名前のワークシートの列 5
および 6
の 10
行をインポートします。
opts.Sheet = '2007'; opts.SelectedVariableNames = [5 6]; opts.DataRange = '2:11'; [DepTime,CRSDepTime] = readvars('airlinesmall_subset.xlsx',opts);
変数を表示します。
[DepTime, CRSDepTime]
ans = 10×2
711 710
652 655
1116 1120
825 825
1411 1400
1935 1935
2005 2005
1525 1525
1133 1105
922 925
特定のシートおよび範囲からの変数の読み取り
スプレッドシート ファイルのデータをプレビューし、特定のシートおよび範囲から列を別個の変数としてインポートします。
スプレッドシート ファイル airlinesmall_subset.xlsx
には 1996 年から 2008 年のデータが複数のワークシートに分かれて含まれています。各ワークシートには、指定の年のデータがあります。ファイル airlinesmall_subset.xlsx
のデータをプレビューします。関数 preview
は、既定で最初のワークシートのデータを表示します。
opts = detectImportOptions('airlinesmall_subset.xlsx'); preview('airlinesmall_subset.xlsx',opts)
ans=8×29 table
Year Month DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime AirTime ArrDelay DepDelay Origin Dest Distance TaxiIn TaxiOut Cancelled CancellationCode Diverted CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay
____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ _______ _________ ________________ ________ ____________ ____________ __________ _____________ _________________
1996 1 18 4 2117 2120 2305 2259 {'HP'} 415 {'N637AW'} 108 99 85 6 -3 {'COS'} {'PHX'} 551 5 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 12 5 1252 1245 1511 1500 {'HP'} 610 {'N905AW'} 79 75 58 11 7 {'LAX'} {'PHX'} 370 3 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 16 2 1441 1445 1708 1721 {'HP'} 211 {'N165AW'} 87 96 74 -13 -4 {'RNO'} {'PHX'} 601 4 9 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 1 1 2258 2300 2336 2335 {'HP'} 1245 {'N183AW'} 38 35 20 1 -2 {'TUS'} {'PHX'} 110 6 12 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 4 4 1814 1814 1901 1910 {'US'} 683 {'N963VJ'} 47 56 34 -9 0 {'DTW'} {'PIT'} 201 6 7 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 31 3 1822 1820 1934 1925 {'US'} 757 {'N912VJ'} 72 65 52 9 2 {'PHL'} {'PIT'} 267 6 14 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 18 4 729 730 841 843 {'US'} 1564 {'N941VJ'} 72 73 58 -2 -1 {'DCA'} {'PVD'} 357 3 11 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
1996 1 26 5 1704 1705 1829 1839 {'NW'} 1538 {'N960N' } 85 94 69 -10 -1 {'DTW'} {'RIC'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}
'2007'
という名前のワークシートから最初の 3 つの変数の 10
行をインポートします。
[Year, Month, DayOfMonth] = readvars('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:C11'); whos Year Month DayOfMonth
Name Size Bytes Class Attributes DayOfMonth 10x1 80 double Month 10x1 80 double Year 10x1 80 double
disp([Year Month DayOfMonth])
2007 1 2 2007 1 3 2007 1 4 2007 1 5 2007 1 7 2007 1 8 2007 1 9 2007 1 11 2007 1 12 2007 1 13
入力引数
filename
— 読み取るファイルの名前
文字ベクトル | string スカラー
読み取るファイルの名前。文字ベクトルまたは string スカラーとして指定します。
ファイルの場所によって、filename
は次のいずれかの形式をとります。
場所 | 形式 | ||||||||
---|---|---|---|---|---|---|---|---|---|
現在のフォルダー、または MATLAB® パス上のフォルダー | ファイル名を 例: | ||||||||
フォルダー内のファイル | ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、 例: 例: | ||||||||
インターネット URL | ファイルをインターネットの Uniform Resource Locator (URL) として指定する場合、 例: | ||||||||
リモートの場所 | リモートの場所に保存されたファイルの場合、
リモートの場所に基づいて、
詳細については、リモート データの操作を参照してください。 例: |
filename
にファイル拡張子が含まれる場合、インポート関数は拡張子からファイル形式を判別します。それ以外の場合は、名前と値のペアの引数'FileType'
を指定してファイルの種類を示さなければなりません。Microsoft® Excel® ソフトウェアがインストールされている Windows® システムで、インポート関数は、使用している Excel のバージョンで認識されるすべての Excel スプレッドシート ファイル形式を読み取ります。
システムに Excel for Windows がない場合、または MATLAB Online™ を使用している場合、インポート関数は
UseExcel
プロパティがfalse
に設定されている状態で動作し、.xls, .xlsx, .xlsm, .xltx, and .xltm
ファイルのみを読み取ります。区切りテキスト ファイルの場合、インポート関数はファイル内の空のフィールドを、
NaN
(数値変数の場合) または空の文字ベクトル (テキスト変数の場合) のどちらかに変換します。テキスト ファイルのすべての行には同じ数の区切り記号がなければなりません。インポート関数はファイル内の意味のない空白を無視します。
データ型: char
| string
opts
— ファイル インポート オプション
SpreadsheetImportOptions
| DelimitedtextImportOptions
| FixedWidthImportOptions
| XMLImportOptions
ファイル インポート オプション。関数 detectImportOptions
によって作成された SpreadsheetImportOptions
、DelimitedTextImportOptions
、FixedWidthImportOptions
、または XMLImportOptions
オブジェクトとして指定します。opts
オブジェクトにはデータ インポートのプロセスを制御するプロパティが含まれています。各オブジェクトのプロパティの詳細については、該当するオブジェクトのページを参照してください。
ファイルの種類 | 出力 |
---|---|
スプレッドシート ファイル | SpreadsheetImportOptions オブジェクト (Sheet 、DataRange 、および VariableNames プロパティにのみ使用可能) |
テキスト ファイル | DelimitedTextImportOptions オブジェクト |
固定幅テキスト ファイル | FixedWidthImportOptions オブジェクト |
XML ファイル | XMLImportOptions オブジェクト |
インポートを制御する方法の詳細については、Control How MATLAB Imports Your Dataを参照してください。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: 'NumHeaderLines',5
は、表形式データの前の最初の 5 行がヘッダー行であることを示します。
WebOptions
— HTTP
または HTTPS
要求オプション
weboptions
オブジェクト
HTTP
または HTTPS
要求オプション。weboptions
オブジェクトとして指定します。weboptions
オブジェクトは、指定した filename
がプロトコル タイプ "http://"
または "https://"
を含むインターネット URL である場合にデータをインポートする方式を決定します。
FileType
— ファイルの種類
'text'
| 'spreadsheet'
ファイルの種類。'FileType'
と 'text'
または 'spreadsheet'
で構成されるコンマ区切りのペアとして指定します。
filename
にファイル拡張子が含まれない場合、または次の拡張子以外の場合は、名前と値のペアの引数 'FileType'
を指定します。
区切りテキスト ファイルの場合、
.txt
、.dat
または.csv
スプレッドシート ファイルの場合、
.xls
、.xlsb
、.xlsm
、.xlsx
、.xltm
,.xltx
または.ods
例: 'FileType','text'
データ型: char
| string
NumHeaderLines
— ヘッダーの行数
正の整数
ファイルのヘッダーの行数。'NumHeaderLines'
と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、ファイル ヘッダーの行数はインポート関数により自動検出されます。
例: 'NumHeaderLines',7
データ型: single
| double
ExpectedNumVariables
— 必要な変数の数
正の整数
必要な変数の数。'ExpectedNumVariables'
と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、変数の数はインポート関数により自動検出されます。
データ型: single
| double
Range
— 読み取るデータの部分
文字ベクトル | string スカラー | 数値ベクトル
テキストまたはスプレッドシート ファイルから読み取るデータの部分。'Range'
と、次のいずれかの形式をとる文字ベクトル、string スカラー、または数値ベクトルで構成されるコンマ区切りのペアとして指定します。
Range の指定方法 | 説明 |
---|---|
開始セル
| 文字ベクトル、string スカラー、または 2 要素数値ベクトルとして、データの開始セルを指定します。
開始セルを使用して、インポート関数は、インポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。 例: |
四角形の範囲
| 次の四角形の範囲フォームのいずれかを使用して、読み取る範囲を正確に指定します。
インポート関数は、指定された範囲内に含まれるデータのみを読み取ります。指定された範囲内の空のフィールドは欠損セルとしてインポートされます。 |
行範囲または列範囲
| Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 インポート関数は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出し、列ごとに 1 つの変数を作成します。 例: あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。 インポート関数は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。 指定された範囲の列数は 例: |
開始行番号
| 正のスカラー行インデックスを使用して、データを含む最初の行を指定します。 インポート関数は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。 例: |
Excel の名前付き範囲
| Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して 例: |
指定なしまたは空
| 指定しない場合、使用範囲はインポート関数により自動検出されます。 例: メモ: "使用範囲" とは、スプレッドシート内で実際にデータが含まれている四角形部分を指します。インポート関数は、データを含まない先頭と末尾の行と列をすべてトリミングして、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。 |
データ型: char
| string
| double
TextType
— インポートされるテキスト データの型
"string"
| "char"
インポートされるテキスト データの型。次のいずれかの値として指定します。
"string"
— テキスト データを string 配列としてインポートします。"char"
— テキスト データを文字ベクトルとしてインポートします。
例: "TextType","char"
DatetimeType
— インポートされる日付と時刻のデータの型
"datetime"
(既定値) | "text"
| "exceldatenum"
(スプレッドシート ファイルのみ)
インポートされる日付と時刻のデータの型。次のいずれかの値として指定します。
値 | 説明 |
---|---|
"datetime" | MATLAB の 詳細については、 |
"text" |
|
"exceldatenum" | Excel のシリアル日付値 値 |
TreatAsMissing
— 欠損データとして解釈するテキスト
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列
欠損データとして解釈するテキスト。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。
例: 'TreatAsMissing',{'NA','TBD'}
は、インポート関数に NA
または TBD
のすべての出現を欠損フィールドとして処理するように指示します。
データ型: char
| string
| cell
Delimiter
— フィールドの区切り記号
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列
区切りテキスト ファイル内のフィールドの区切り記号。string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。
例: "Delimiter","|"
例: "Delimiter",[";","*"]
Whitespace
— 空白として扱う文字
文字ベクトル | string スカラー
空白として扱う文字。1 文字以上が含まれる文字ベクトルまたは string スカラーとして指定します。
例: 'Whitespace',' _'
例: 'Whitespace','?!.,'
LineEnding
— 行末の文字
["\n","\r","\r\n"]
(既定値) | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列
行末の文字。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。
例: "LineEnding","\n"
例: "LineEnding","\r\n"
例: "LineEnding",["\b",":"]
CommentStyle
— コメントのスタイル
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列
コメントのスタイル。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。単一行および複数行のコメントでは、開始識別子は空白以外の最初の文字でなければなりません。単一行のコメントでは、単一の識別子を指定して、その識別子で開始している行をコメントとして扱います。複数行のコメントでは、開始識別子 (最初のもの) から終了識別子 (2 番目のもの) までの行がコメントとして扱われます。識別子の文字ベクトルを 2 つまで指定できます。
たとえば、空白以外の最初の文字としてパーセント記号に続く行を無視するには、CommentStyle
を "%"
に指定します。
例: "CommentStyle",["/*"]
例: "CommentStyle",["/*","*/"]
Encoding
— 文字エンコード スキーム
'UTF-8'
| 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
| ...
ファイルに関連付けられた文字エンコード スキーム。'Encoding'
と 'system'
で構成されるコンマ区切りのペア、または標準の文字エンコード スキーム名として指定します。エンコードを指定しない場合、関数 readvars
は自動文字セット検出を使用して、ファイルの読み取り時にエンコードを判断します。
インポート オプションに加えて引数 'Encoding'
を指定した場合、関数 readvars
は 'Encoding'
で指定された値を使用して、インポート オプションで定義されたエンコードをオーバーライドします。
例: 'Encoding','UTF-8'
は、UTF-8 をエンコードとして使用します。
例: 'Encoding','system'
はシステムの既定のエンコードを使用します。
データ型: char
| string
DurationType
— duration データの出力データ型
'duration'
(既定値) | 'text'
テキスト ファイルからの duration データの出力データ型。'DurationType'
と 'duration'
または 'text'
のいずれかで構成されるコンマ区切りのペアとして指定します。
値 | インポートされる duration データの型 |
---|---|
'duration' | MATLAB の 詳細については、 |
'text' |
|
データ型: char
| string
DateLocale
— 日付を読み取るロケール
文字ベクトル | string スカラー
日付を読み取るロケール。'DateLocale'
と、
の形式の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。ここで、次のようになります。xx
_YY
YY
は国を表す大文字の ISO 3166-1 alpha-2 コードxx
は言語を表す小文字 2 文字の ISO 639-1 コード
次の表に一般的なロケールの値を示します。
ロケール | 言語 | 国 |
---|---|---|
'de_DE' | ドイツ語 | ドイツ |
'en_GB' | 英語 | 英国 |
'en_US' | 英語 | 米国 |
'es_ES' | スペイン語 | スペイン |
'fr_FR' | フランス語 | フランス |
'it_IT' | イタリア語 | イタリア |
'ja_JP' | 日本語 | 日本 |
'ko_KR' | 韓国語 | 韓国 |
'nl_NL' | オランダ語 | オランダ |
'zh_CN' | 簡体字中国語 | 中国 |
%D
書式指定子を使用してテキストを datetime
値として読み取る場合、DateLocale
を使用して、インポート関数が月と曜日の名前および略語を解釈するためのロケールを指定します。
インポート オプション opts
に加えて引数 DateLocale
を指定した場合、インポート関数は引数 DateLocale
で指定された値を使用して、インポート オプションで定義されたロケールをオーバーライドします。
例: 'DateLocale','ja_JP'
DecimalSeparator
— 小数点の区切りを示す文字
文字ベクトル | string スカラー
数値変数内の小数点の区切りを示す文字。文字ベクトルまたは string スカラーとして指定します。インポート関数は、DecimalSeparator
の名前と値のペアで指定される文字を使用して、数値の整数部分と小数部分を区別します。
整数データ型に変換すると、小数部分をもつ数値は最も近い整数に丸められます。
例: 名前と値のペアが 'DecimalSeparator',','
のように指定される場合、インポート関数はテキスト "3,14159"
を数値 3.14159
としてインポートします。
データ型: char
| string
ThousandsSeparator
— 3 桁ごとの区切りを示す文字
文字ベクトル | string スカラー
数値変数内の 3 桁ごとの区切りを示す文字。文字ベクトルまたは string スカラーとして指定します。3 桁ごとの区切り文字は視覚的な区切りとして機能し、数値を 3 桁ごとにグループ化します。インポート関数は、ThousandsSeparator
の名前と値のペアで指定される文字を使用して、インポートされる数値を解釈します。
例: 名前と値のペアが 'ThousandsSeparator',','
のように指定される場合、インポート関数はテキスト "1,234,000"
を 1234000
としてインポートします。
データ型: char
| string
TrimNonNumeric
— 非数値文字の削除
false
(既定値) | true
非数値文字を数値変数から削除します。logical true
または false
として指定します。
例: 名前と値のペアが 'TrimNonNumeric',true
のように指定される場合、インポート関数は '$500/-'
を 500
として読み取ります。
データ型: logical
ConsecutiveDelimitersRule
— 連続する区切り記号を管理する方法
"split"
| "join"
| "error"
区切りテキスト ファイル内の連続する区切り記号を管理する方法。次の表の値のいずれかとして指定します。
値 | 動作 |
---|---|
"split" | 連続する区切り記号を複数のフィールドに分割します。 |
"join" | 複数の区切り記号を結合して 1 つの区切り記号にします。 |
"error" | エラーを返し、インポート操作をキャンセルします。 |
LeadingDelimitersRule
— 先頭の区切り記号を管理する方法
"keep"
| "ignore"
| "error"
区切りテキスト ファイル内の先頭の区切り記号を管理する方法。次の表の値のいずれかとして指定します。
値 | 動作 |
---|---|
"keep" | 区切り記号を維持します。 |
"ignore" | 区切り記号を無視します。 |
"error" | エラーを返し、インポート操作をキャンセルします。 |
TrailingDelimitersRule
— 末尾の区切り記号を管理する方法
'keep'
| 'ignore'
| 'error'
区切りテキスト ファイル内の末尾の区切り記号を管理する方法。次の表の値のいずれかとして指定します。
先頭の区切り記号のルール | 動作 |
---|---|
'keep' | 区切り記号を維持します。 |
'ignore' | 区切り記号を無視します。 |
'error' | エラーを返し、インポート操作を中止します。 |
Sheet
— 読み取り元のシート
空の文字配列 ''
(既定値) | 文字ベクトル | string スカラー | 正のスカラー整数
読み取り元のシート。空の文字配列、シート名を含む文字ベクトルまたは string スカラー、あるいはシート インデックスを示す正の整数スカラーとして指定します。インポート関数は Sheet
プロパティに指定された値に基づいて、表に説明されているように動作します。
指定 | 動作 |
---|---|
'' (既定) | 1 番目のシートからデータをインポートします。 |
名前 | スプレッドシート ファイル内のシートの順序に関係なく、一致する名前のシートからデータをインポートします。 |
整数 | スプレッドシート ファイル内のシート名に関係なく、整数で示された位置にあるシートからデータをインポートします。 |
データ型: char
| string
| single
| double
UseExcel
— Microsoft Excel for Windows のインスタンスを起動するためのフラグ
false
(既定値) | true
スプレッドシート データを読み取るときに、Microsoft Excel for Windows のインスタンスを起動するためのフラグ。'UseExcel'
と、true
または false
のいずれかで構成されるコンマ区切りのペアとして指定します。
'UseExcel'
パラメーターは、次の値のいずれかに設定できます。
true
— インポート関数は、ファイルを読み取るときに Microsoft Excel のインスタンスを起動します。false
— インポート関数は、ファイルを読み取るときに Microsoft Excel のインスタンスを起動しません。このモードで動作しているインポート関数の機能では、サポートするファイル形式および式やマクロなどの対話型機能が異なります。
UseExcel |
|
|
---|---|---|
サポートされているファイル形式 |
|
|
式やマクロなどの対話型機能のサポート | あり | なし |
Windows プラットフォームでスプレッドシート ファイルを読み取るときに Microsoft Excel のインスタンスを起動する場合は、'UseExcel'
パラメーターを true
に設定します。
UseExcel
は非対話型の自動化された環境ではサポートされません。
バージョン履歴
R2019a で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
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)