hour

入力の日付と時刻の時間コンポーネント

構文

h = hour(t)

説明

h = hour(t) は、t で指定した日付と時刻のそれぞれについて時間コンポーネントを返します。

出力 h は double 配列であり、0 から 23 の整数値が含まれます。t の値の時間コンポーネントに値を代入するには、t.Hour を使用して Hour プロパティを変更します。

例

datetime 値の時間番号の取得

t = datetime('today'):hours(8):datetime('tomorrow');
t.Format = 'MMM dd, HH:mm'

t = 1×4 datetime
   Aug 09, 00:00   Aug 09, 08:00   Aug 09, 16:00   Aug 10, 00:00

h = hour(t)

h = 1×4

     0     8    16     0

入力引数

t — 入力の日付と時刻

datetime 配列

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

Financial Toolbox™ を必要とする従来のコードをサポートできるように、hour ではシリアル日付値やテキストを入力として使用することもできますが、この方法は推奨されません。詳細については、バージョン履歴を参照してください。

拡張機能

tall 配列

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

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

C/C++ コード生成

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

使用上の注意および制限:

• 生成されたコードでは、この関数が入力としてサポートするのは datetime 配列のみです。生成されるコードでシリアル日付値やテキストを入力として指定することはできません。

スレッドベースの環境

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

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

分散配列

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

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

バージョン履歴

R2014b で導入

R2022a: シリアル日付値とテキストの入力は非推奨

hour ではシリアル日付値とテキストの入力もサポートされていますが、推奨されるのは datetime 値です。datetime データ型を使用すると、柔軟な日付と時刻の形式、ナノ秒単位の精度のストレージ、タイム ゾーンと夏時間を考慮するためのプロパティを使用できます。

シリアル日付値またはテキストを datetime 値に変換するには、関数 datetime を使用します。以下に例を示します。

t = datetime(738427.656845093,"ConvertFrom","datenum");
h = hour(t)

h =

    15

現在のところ、シリアル日付値やテキストの入力のサポートを削除する予定はありません。

R2022a: Financial Toolbox と MATLAB の関数 hour を統合

以前のリリースでは、関数 hour は 2 種類ありました。1 つは MATLAB^® の関数で、datetime 値を使用していました。もう 1 つは Financial Toolbox の関数で、シリアル日付値やテキスト値を使用していました。R2022a 以降では、Financial Toolbox がなくても hour™ を呼び出せます。hour を MATLAB から呼び出す場合、従来のすべての入力型を使用できます。

たとえば、MATLAB からシリアル日付値とテキストを使用して次の呼び出しを行うことができます。

h = hour(738427.656845093)

h =

    15

h = hour("2021/09/28 15:45:51.4160")

h =

    15

さらに、hour では 1 番目の入力が datetime 配列でない場合に、日付形式を指定する 2 番目の入力を使用できます。

h = hour(t,F)

この構文では、関数 datestr について記載されている有効な日付形式を使用して F を指定します。ただし、'Q' 書式指定子はサポートされません。以下に例を示します。

h = hour("2021/09/28 15:45:51.4160","yyyy/dd/mm hh:MM:ss.fff")

h =

    15

参考

minute | second | timeofday | hms