hms

R2026b

datetime または duration の時間、分、秒数

構文

[h,m,s] = hms(t)

説明

[h,m,s] = hms(t) は、t 内の datetime または duration 値の時間、分、秒の値を、それぞれ個別の数値配列として返します。出力 h および m は整数値を含みます。出力 s は小数部を含む場合があります。h、m および s は t と同じサイズです。

datetime 配列で hms を呼び出した場合、hour、minute、second の各関数を呼び出した場合と等価になります。

例

datetime 配列の時間、分、秒数を求めます。

t1 = datetime('now','Format','HH:mm:ss.SSS');
t = t1 + minutes(0:45:135)

t = 1×4 datetime
   00:46:27.856   01:31:27.856   02:16:27.856   03:01:27.856

[h,m,s] = hms(t)

h = 1×4

     0     1     2     3

m = 1×4

    46    31    16     1

s = 1×4

   27.8565   27.8565   27.8565   27.8565

hms は時、分、秒番号を個別の配列で返します。

入力引数

t — 入力の日付と時刻

datetime 配列または duration 配列

入力の日付と時刻。datetime 配列または duration 配列として指定します。

データ型: datetime | duration

出力引数

h — 時間番号

数値配列

時間番号。0 ～ 23 の整数値の数値配列として返されます。出力 h は double 型で t と同じサイズになります。

m — 分番号

数値配列

分番号。0 ～ 59 の整数値の数値配列として返されます。出力 m は double 型で t と同じサイズになります。

s — 秒数

数値配列

秒数。0 以上 60 未満の値の数値配列として返され、小数部が含まれる場合があります。タイム ゾーンが UTCLeapSeconds である datetime 値の場合、出力 s はうるう秒発生中の時間について 60 と 61 の間の値を含む場合があります。出力 s は double 型で t と同じサイズになります。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

hms 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

hms 関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

hms 関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2014b で導入

参考

ymd | hour | minute | second