writetimetable

ファイルへの timetable の書き込み

ページ内をすべて折りたたむ

構文

writetimetable(TT)
writetimetable(TT,filename)
writetimetable(___,Name,Value)

説明

writetimetable(TT) は timetable TT をコンマ区切り形式のテキスト ファイルに書き込みます。ファイル名は timetable のワークスペースの変数名で、拡張子 .txt が追加されます。writetimetable が入力 timetable 名からファイルの名前を作成できない場合、ファイル timetable.txt に書き込みます。

TT の各変数の各列は、出力ファイルの 1 つの列になります。TT の変数名は、ファイルの最初の行の列見出しになります。関数 writetimetable は既存のファイルをいずれも上書きします。

例

writetimetable(TT,filename) は、filename で指定された名前と拡張子のファイルに書き込みます。

writetimetable は、指定された拡張子に基づいてファイル形式を判別します。拡張子は、次のいずれかでなければなりません。

  • 区切りテキスト ファイルの場合、.txt、.dat または .csv

  • Excel® スプレッドシート ファイルの場合、.xls、.xlsm または .xlsx

  • Excel for Windows® を備えたシステムでサポートされる Excel スプレッドシート ファイルの場合、.xlsb

  • 拡張マークアップ言語 (XML) の場合、.xml。

例

writetimetable(___,Name,Value) は、1 つ以上の Name,Value ペアの引数で指定された追加のオプションを使用して、前述の構文の任意の入力引数を含めることができます。

たとえば、変数名を出力ファイルの列見出しとして書き込むかどうかを指定することができます。

例

例

すべて折りたたむ

ライブ スクリプトを開く

timetable を作成し、コンマ区切りのテキスト ファイルに書き込んでから、その timetable を区切り記号が異なる別のテキスト ファイルに書き込みます。

行時間の duration ベクトル RowTimes を使用し、ワークスペースに timetable を定義します。

RowTimes = seconds(1:5)';
TT = timetable(RowTimes,[98;97.5;97.9;98.1;97.9],[120;111;119;117;116],...
               'VariableNames',{'Reading1','Reading2'})
TT=5×2 timetable
    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

timetable をコンマ区切り形式のテキスト ファイルに書き込んで、ファイルの内容を表示します。関数 writetimetable は、TT.txt という名前のテキスト ファイルを出力します。

writetimetable(TT)
type 'TT.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

同じ timetable を区切り記号が異なるテキスト ファイルに書き込むには、'Delimiter' の名前と値のペアを使用します。

writetimetable(TT,'TT_bar.txt','Delimiter','bar')
type '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
ライブ スクリプトを開く

timetable を作成し、スプレッドシート ファイルに書き込んでから、ファイルの内容を表示します。

行時間を datetime ベクトルとして使用し、ワークスペースに timetable を定義します。

Y = [2014:2018]'; M = ones(5,1); D = ones(5,1);
RowTimes = datetime(Y,M,D); % Create Row Times
TT = timetable(RowTimes,[98;97.5;97.9;98.1;97.9],[120;111;119;117;116],...
               'VariableNames',{'Reading1','Reading2'})
TT=5×2 timetable
     RowTimes      Reading1    Reading2
    ___________    ________    ________

    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' に table を書き込みます。既定で、関数 writetimetable はファイル内の最初のワークシートに書き込みます。'Sheet' の名前と値のペアを使用して書き込み先のワークシートを指定します。

writetimetable(TT,'TT.xlsx','Sheet',2)

ファイルの内容を読み取って表示します。

readtimetable('TT.xlsx','Sheet',2) 
ans=5×2 timetable
          RowTimes          Reading1    Reading2
    ____________________    ________    ________

    01-Jan-2014 00:00:00        98        120   
    01-Jan-2015 00:00:00      97.5        111   
    01-Jan-2016 00:00:00      97.9        119   
    01-Jan-2017 00:00:00      98.1        117   
    01-Jan-2018 00:00:00      97.9        116

入力引数

すべて折りたたむ

入力 timetable。

ファイル名。文字ベクトルまたは string スカラーとして指定します。

書き込み先の場所によって、filename は次のいずれかの形式にできます。

場所

形式

現在のフォルダー

現在のフォルダーに書き込むには、ファイルの名前を filename に指定します。

例: 'myTextFile.csv'

その他のフォルダー

現在のフォルダーとは異なるフォルダーに書き込むには、絶対パス名または相対パス名を filename に指定します。

例: 'C:\myFolder\myTextFile.csv'

例: 'myFolder\myExcelFile.xlsx'

リモートの場所

リモートの場所に書き込むには、filename に次の形式の Uniform Resource Locator (URL) として指定されたファイルの絶対パスを含めなければなりません。

scheme_name://path_to_file/my_file.ext

リモートの場所に基づいて、scheme_name には次の表の値のいずれかを指定できます。

リモートの場所scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs
HDFS™hdfs

詳細については、リモート データの操作を参照してください。

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

  • filename にファイル拡張子が含まれる場合、書き込み関数は拡張子からファイル形式を判別します。そうでない場合、書き込み関数はコンマ区切りのテキスト ファイルを作成し、拡張子 .txt を追加します。代替方法として、ファイル拡張子を付けずに filename を指定し、'FileType' 名前と値のペアの引数を含めてファイルの種類を示すことができます。

  • filename が存在しない場合、書き込み関数がファイルを作成します。

  • filename が既存のテキスト ファイルの名前である場合、書き込み関数はそのファイルを上書きします。

  • filename が既存のスプレッドシート ファイルの名前である場合、書き込み関数はそのデータを指定した場所に書き込みますが、入力データの範囲外にあるいずれの値も上書きしません。

データ型: char | string

名前と値の引数

すべて展開する

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: 'WriteVariableNames',false は、変数名が出力ファイルの最初の行として含まれないようにすることを示します。

テキスト ファイルとスプレッドシート ファイル

すべて展開する

ファイルの種類。'FileType' と、'text' または 'spreadsheet' を含む文字ベクトルまたは string から構成されるコンマ区切りのペアとして指定します。

'FileType' 名前と値ペアは、filename 入力引数と一緒に使用しなければなりません。filename 入力引数に標準のファイル拡張子が含まれている場合、'FileType' の名前と値のペアの引数を指定する必要はありません。次の標準のファイル拡張子は、書き込み関数で認識されます。

  • 区切りテキスト ファイルの場合、.txt、.dat または .csv

  • Excel スプレッドシート ファイルの場合、.xls、.xlsm または .xlsx

  • Excel for Windows を備えたシステムでサポートされる Excel スプレッドシート ファイルの場合、.xlsb

例: 'FileType','spreadsheet'

データ型: char | string

変数名を列見出しとして書き込むためのインジケーター。'WriteVariableNames' と、true または false のいずれかで構成されるコンマ区切りのペアとして指定します。

インジケーター

動作

true

書き込み関数は、変数名を出力の列見出しとして含めます。これは既定の動作です。

false

書き込み関数は出力に変数名を含めません。

日付を書き込むためのロケール。'DateLocale' と、文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。datetime 値をファイルに書き込む場合、DateLocale を使用して writetimetable が月と曜日の名前および略語を書き込むロケールを指定します。xx_YY の形式の文字ベクトルまたは string。xx は ISO 639-1 で定義された小文字 2 文字の言語コードで、YY は ISO 3166-1 alpha-2 で定義された大文字の国コードです。ロケールの一般的な値の一覧については、関数 datetime の Locale の名前と値のペア引数を参照してください。

日付が Excel 形式の日付として記述できる場合、書き込み関数は常に 'DateLocale' パラメーターの値を無視します。

例: 'DateLocale','ja_JP'

データ型: char | string

書き込みモード。'WriteMode' と、文字ベクトルまたは string スカラーから構成されるコンマ区切りのペアとして指定します。ファイルの種類に基づいて、書き込みモードを選択します。

ファイルの種類

書き込みモード

テキスト ファイル

  • 'overwrite' (既定の設定) — ファイルを上書きします。

  • 'append' — データをファイルに追加します。

指定したファイルが存在しない場合、書き込み関数は新しいファイルを作成してデータを書き込みます。

スプレッドシート ファイル

  • 'inplace' (既定の設定) — 入力データにより占有された範囲のみを更新します。書き込み関数は入力データにより占有された範囲外のデータは一切変更しません。

    • シートを指定しない場合、書き込み関数は最初のシートに書き込みます。

  • 'overwritesheet' — 指定されたシートをクリアし、クリアしたシートに入力データを書き込みます。

    • シートを指定しない場合、書き込み関数は最初のシートをクリアし、それに入力データを書き込みます。

  • 'append' — 書き込み関数は指定されたシートの占有範囲の末尾に入力データを追加します。

    • シートを指定しない場合、書き込み関数は最初のシートの占有範囲の末尾に入力データを追加します。

  • 'replacefile' — 他のすべてのシートをファイルから削除し、指定されたシートをクリアして入力データを書き込みます。

    • シートを指定しない場合、書き込み関数は他のすべてのシートをファイルから削除し、最初のシートをクリアして入力データを書き込みます。

    • 指定したファイルが存在しない場合、書き込み関数は新しいファイルを作成して最初のシートに入力データを書き込みます。

  • WriteVariableNames が true である場合、書き込み関数は書き込みモード 'append' をサポートしません。

  • スプレッドシート ファイルの場合、次となります。

    • 書き込みモードが 'append' である場合、書き込み関数は Range パラメーターをサポートしません。

    • 指定したファイルが存在しない場合、書き込み関数は 'replacefile' と同じアクションを実行します。

例: 'WriteMode','append'

データ型: char | string

テキスト ファイルのみ

すべて展開する

フィールドの区切り記号。'Delimiter' と、次の指定子のいずれかを含む文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

指定子

フィールドの区切り記号

','

'comma'

コンマ。これは既定の動作です。

' '

'space'

スペース

'\t'

'tab'

タブ

';'

'semi'

セミコロン

'|'

'bar'

縦棒

'Delimiter' 名前と値のペアは区切り付きテキスト ファイルに対してのみ使用できます。

例: 'Delimiter','space'

データ型: char | string

引用符付きテキスト書き込みのインジケーター。"minimal"、"all"、または "none" として指定します。

  • QuoteStrings が "minimal" の場合、この関数は区切り記号、行末、または二重引用符が含まれるすべての変数を二重引用符で囲みます。

  • QuoteStrings が "all" の場合、この関数はすべてのテキスト変数、categorical 変数、datetime 変数、duration 変数を二重引用符で囲みます。

  • QuoteStrings が "none" の場合、この関数は変数を二重引用符で囲みません。

名前と値の引数 QuoteStrings は、区切り形式のテキスト ファイルでのみ使用できます。

ファイルに関連付けられた文字エンコード スキーム。'Encoding' と 'system' で構成されるコンマ区切りのペア、または標準の文字エンコード スキーム名として指定します。エンコードを何も指定しない場合、書き込み関数は UTF-8 を使用してファイルに書き込みます。

例: 'Encoding','UTF-8' は、UTF-8 をエンコードとして使用します。

データ型: char | string

スプレッドシート ファイルのみ

すべて展開する

書き込み先のワークシート。'Sheet' と、ワークシート名またはワークシート インデックスを示す正の整数を含む文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。ワークシート名にコロン (:) を含めることはできません。スプレッドシート ファイルのシートの名前を調べるには、sheets = sheetnames(filename) を使用します。詳細については、sheetnames を参照してください。

書き込み先のワークシートを、名前またはインデックスで指定します。

  • 名前 — 指定したシート名がファイルに存在しない場合、書き込み関数がワークシート コレクションの最後に新しいシートを追加します。

  • インデックス — 指定したシート インデックスがワークシート数より大きい場合、書き込み関数が、ワークブック内のワークシートの数がシート インデックスと等しくなるまで空のシートを追加します。書き込み関数は新しいワークシートが追加されたことを示す警告も生成します。

'Sheet' 名前と値のペアはスプレッドシート ファイルでのみ使用できます。

例: 'Sheet',2

例: 'Sheet', 'MySheetName'

データ型: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

書き込み対象のワークシートの四角形部分。'Range' と、次のいずれかの形式の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

Range の値の形式 説明
'Corner1'

Corner1 は、書き込む領域の最初のセルを指定します。書き込み関数はこのセルからデータを書き込みます。

例: 'Range','D2'

'Corner1:Corner2'

Corner1 と Corner2 は、書き込む領域を定義する 1 組の対角です。たとえば、'D2:H4' は、ワークシート上の 2 つの角 D2 と H4 の間にある 3 行 5 列の四角形領域を表します。'Range' 名前と値のペアの引数では大文字小文字は区別されず、Excel A1 参照スタイル (Excel ヘルプを参照) が使用されます。

例: 'Range','D2:H4'

  • 指定範囲が入力データのサイズより小さい場合、書き込み関数は入力データのうち範囲に収まるサブセットのみを書き込みます。

  • 指定範囲が入力データのサイズより大きい場合、書き込み関数は残りの領域をそのままにします。

'Range' 名前と値のペアは、Excel ファイルと一緒にのみ使用できます。

例: 'Range', 'A1:F10'

データ型: char | string

スプレッドシート データを書き込むときに、Windows 版 Microsoft Excel のインスタンスを起動するためのフラグ。'UseExcel' と、true または false のいずれかで構成されるコンマ区切りのペアとして指定します。

'UseExcel' パラメーターは、次の値のいずれかに設定できます。

  • true — 書き込み関数はファイルを書き込むときに Microsoft Excel のインスタンスを起動します。

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

UseExcel

true

false

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

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

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

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

あり

なし

Windows プラットフォームでスプレッドシート ファイルに書き込むときに、Microsoft Excel のインスタンスを起動するには、'UseExcel' パラメーターを true に設定します。

UseExcel は非対話型の自動化された環境ではサポートされません。

列幅の自動調整。true または false として指定します。0 の値または false を指定すると、writetimetable はセルのデータに合わせる列幅の自動調整を行いません。

例: 'AutoFitWidth',0

既存スプレッドシートのセルの書式設定の保持。true または false として指定します。false を指定すると、writetimetable はスプレッドシートのセルの書式設定を保持しません。書式設定には、フォント、セルの境界線、色付きのセルなどの要素が含まれます。

datetime データをスプレッドシート ファイルに書き込む場合、既存のセルの書式設定を保持するには、'PreserveFormat' と 'UseExcel' の両方の名前と値のペアを true に設定しなければなりません。datetime データをファイルに書き込む際に 'UseExcel' が false に、'PreserveFormat' が true に設定されていると、writetimetable はファイルの既存のセルの書式設定を保持しません。

例: 'PreserveFormat',false

XML ファイルのみ

すべて展開する

属性接尾辞。'AttributeSuffix' と、出力 XML ファイルで属性として書き込む入力 table の変数名を示す文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

たとえば、入力 table の変数名 AttName_att について、'AttributeSuffix','_att' を指定して、'AttName' が出力 XML ファイルで属性として書き込まれる必要があることを示します。

  • 'AttributeSuffix' を指定しない場合、writetimetable は既定で出力 XML ファイルで属性として変数を接尾辞 'Attribute' を付けて書き込みます。

  • 'AttributeSuffix' の値として指定される属性が入力 table の変数名に追加される接尾辞に一致する場合、その接尾辞は出力 XML ファイルの変数名から除かれます。たとえば、'AttributeSuffix','_att' を指定する場合、MyField_att という名前の入力 table の変数は XML ファイルの MyField という属性に対応します。

例: 'AttributeSuffix','_att'

XML 行ノード名。'RowNodeName' と、書き込み関数が出力 XML ファイルに入力 table の行に対応するノード名として書き込む文字ベクトルまたは string スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。RowNodeName を指定しない場合、書き込み関数は出力 table に行ノードの名前として 'row' を書き込みます。

例: 'TableNodeName','RootName'

XML ルート ノード名。'TableNodeName' と、書き込み関数が出力 XML ファイルにルート ノード名として書き込む文字ベクトルまたは string スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。TableNodeName を指定しない場合、書き込み関数は出力 table にルート ノードの名前として 'table' を書き込みます。

例: 'TableNodeName','RootName'

アルゴリズム

  • 場合によっては、関数 writetimetable で作成したファイルが入力データを正確に表していないことがあります。これは、関数 readtimetable を使用してそのファイルを読み取ったときに判明します。結果のデータに、元のデータと完全に同じ形式または内容が含まれない可能性があります。timetable を保存し、後で元の timetable と厳密に一致する同一のデータおよび構成を復元する必要がある場合は、MAT ファイルとして保存します。次の場合に、writetimetable が書き込む table は厳密に一致しません。

    • writetimetable が long g 形式を使用した数値データと、categorical データまたは文字データを引用符なしのテキストとして書き出す。

    • writetimetable が、次元数が 2 を超える変数を 2 次元変数として、後続の次元を折りたたんで出力します。

    • cell 値をもつ変数の場合、writetimetable は、cell の内容のデータ型に基づいて変数の書き込み方が異なります。

      • cell の内容のデータ型が数値、テキスト、logical、categorical、datetime または duration の場合、関数 writetimetable は各 cell の内容を 1 行として、区切り記号で区切られた複数のフィールドに書き込みます。

      • そうでない場合、関数 writetimetable は単一の空のフィールドを書き出します。

  • Excel は Inf 値を 65535 に変換します。MATLAB® は NaN、NaT、categorical 値 <undefined> および string 値 <missing> を空のセルに変換します。

バージョン履歴

R2019a で導入

参考

| | |