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
次の例では、intHours、intMinutes、intSeconds の各列の値に基づいて時刻が作成されます。
= TIME([intHours],[intMinutes],[intSeconds])