TIME

適用対象:計算列計算テーブルメジャービジュアル計算

数値として指定された時間、分、および秒を datetime 形式の時刻に変換します。

構文

TIME(hour, minute, second)  

パラメーター

用語 定義
hour インポート モード: 時間を表す 0 から 32767 までの数値。
23 より大きい値はすべて 24 で除算され、その剰余が (1 日の端数として表される) hour 値として扱われます。
例: TIME(27,0,0) = TIME(3,0,0) = 午前 3:00:00

DirectQuery モード: 時間を表す 0 から 23 までの数値。
minute インポート モード: 分を表す 0 から 32767 までの数値。
59 分より大きい値はすべて、hour と minute に変換されます。
1440 (24 時間) より大きい値では日付部分は変更されません。代わりに、それは 1440 で除算され、その剰余が (1 日の端数として表される) minute 値として扱われます。
例: TIME(0,2190,0) = TIME(0,750,0) = TIME(12,30,0) = 午後 12:30:00

DirectQuery モード: 分を表す 0 から 59 までの数値。
second インポート モード: 秒を表す 0 から 32767 までの数値。
59 より大きい値はすべて、hour、minute、second に変換されます。
例: TIME(0,0,2000) = TIME(0,33,20) = 午前 12:33:20

DirectQuery モード: 秒を表す 0 から 59 までの数値。

戻り値

00:00:00 (午前 12:00:00) から 23:59:59 (午後 11:59:59) までの範囲の時刻 (datetime)。

解説

  • 日付と時刻をシリアル値として格納する Microsoft Excel とは異なり、DAX では日付と時刻の値が datetime 形式で使用されます。 DAX 関数で日付/時刻値を使用すると、他の形式の数値が暗黙的に変換されます。 シリアル番号を使用する必要がある場合は、書式設定を使用して、数値の表示方法を変更できます。

  • 時刻値は日付値の一部で、シリアル番号システムでは 10 進数で表されます。 したがって、datetime 値 12:00 PM は、1 日の半分であるため、0.5 に相当します。

  • TIME 関数の引数には、直接入力した値、別の式の結果、または数値を含む列への参照を指定できます。

  • 日付と時刻は、形式 dt"YYYY-MM-DD"dt"YYYY-MM-DDThh:mm:ss"、または dt"YYYY-MM-DD hh:mm:ss" でリテラルとして指定することもできます。 リテラルとして指定した場合、式で TIME 関数を使用する必要はありません。 詳細については、「DAX の構文 | 日付と時刻」を参照してください。

  • この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。

例 1

次の例では、どちらも時刻 3:00 AM が返されます。

= TIME(27,0,0)
= TIME(3,0,0)  

例 2

次の例では、どちらも時刻 12:30 PM が返されます。

= TIME(0,750,0)
= TIME(12,30,0)  

例 3

次の例では、intHoursintMinutesintSeconds の各列の値に基づいて時刻が作成されます。

= TIME([intHours],[intMinutes],[intSeconds])  

DATE
日付と時刻関数