time2num

duration 配列または datetime 配列を、指定した時間単位をもつ数値ベクトルに変換する

R2020a 以降

構文

[x,origUnit] = time2num(T,targetUnit)

説明

time2num は、診断特徴デザイナーで生成されたコードで使用される関数です。

[x,origUnit] = time2num(T,targetUnit) は、時間配列 T を元のデータ型と単位から、targetUnit の単位で表現された数値ベクトル x に変換します。たとえば、T がデータ測定のタイムスタンプを含む datetime ベクトルであり、T を、時間単位で時を表す数値ベクトル x に変換するとします。x = time2num(T,"hours") を使用します。

x が既に数値ベクトルである場合、time2num は x を T に設定し、targetUnit を無視します。

診断特徴デザイナーで生成されるコードでは、スペクトルの処理や他の計算を実行する際に time2num が使用されます。

入力引数

T — 時間配列

datetime 配列 | duration 配列 | numeric ベクトル

サンプリング時点の時間配列。1 次元 datetime 配列、1 次元 duration 配列、または数値ベクトルとして表します。

targetUnit — 時間単位

"seconds" | "minutes" | "hours" | "days" | "years" | " "

変換後の数値ベクトルに対応する時間単位。string として指定します。targetUnit は以下のいずれかにできます。

• "seconds"

• "minutes"

• "hours"

• "days"

• "years"

• ""

targetUnit を省略するか、targetUnit を "" に設定した場合、time2num は元の時間単位を T から導出します。

• T が duration 配列の場合、time2num は timeUnit を duration 配列の単位に設定。

• T が datetime 配列の場合、time2num はサンプル時間に基づいて timeUnit の最適な値を決定。たとえば、T のタイムスタンプが 100 秒おきである場合、time2num は timeUnit を "minutes" に設定します。

• T が数値配列の場合、time2num は targetUnit を無視し、x を T に設定。

例: tNumeric = time2num(Tacho.Time,"seconds")

出力引数

x — サンプリング時点

数値ベクトル

サンプリング時点。数値ベクトルとして返されます。開始点 x(1) は T のデータ型によって異なります。

• T が datetime 配列の場合、x(1) は 0。

• T が duration 配列または数値ベクトルの場合、x(1) は T(1) で、targetUnit が指定されていれば、targetUnit の単位に変換される。

• T が数値ベクトルの場合、x(1) は T(1)。

origUnit — 元の単位

string

T の元の単位。string として返されます。

バージョン履歴

R2020a で導入

参考

datetime | duration | effectivefs