DATE
指定された日付を datetime 形式で返します。
構文
DATE(<year>, <month>, <day>)
パラメーター
| 用語 | 定義 |
|---|---|
| 年 | 年を表す数値。 year 引数の値には、1 から 4 桁の数字を含めることができます。 year 引数は、コンピューターで使用されている日付システムに従って解釈されます。 1900 年 3 月 1 日以降の日付がサポートされています。 小数点以下の桁数を含む数値を入力すると、数値は丸められます。 値が 9999 より大きいかゼロ未満 (負の値) の場合、関数が #VALUE! エラーを返します。 year の値が 0 から 1899 の場合は、その値に 1900 が加算され、最終的な値が生成されます。 次の例を参照してください。 注: 望ましくない結果を防ぐために、可能な限り、year 引数には 4 桁を使用するようにしてください。 たとえば、07 を使用すると、年の値として 1907 が返されます。 |
| 月 | 月を表す数値、または以下の規則に従った計算。 負の整数はサポートされていません。 有効な値は 1 から 12 です。 month が 1 から 12 の数値の場合は、その年の月を表します。 1 は 1 月を表し、2 は 2 月を表し、以下同様に続き、12 は 12 月を表します。 12 を超える整数を入力すると、次の計算が行われます。month の値が year に加算され、日付が計算されます。 たとえば、DATE (2008,18,1) がある場合、この関数からは 2009 年 6 月 1 日に相当する datetime 値が返されます。これは、2008 年の初めに 18 か月が加算されると、2009 年 6 月の値が得られるためです。 以下の例を参照してください。 |
| day | 日を表す数値、または以下の規則に従った計算。 負の整数はサポートされていません。 有効な値は 1 から 31 です。 day が、指定された月の 1 日から最終日までの数である場合、その月の日を表します。 特定の月の最終日よりも大きい整数を入力すると、次の計算が行われます。day の値が month に加算され、日付が計算されます。 たとえば、数式 DATE( 2008, 3, 32) の場合、DATE 関数からは 2008 年 4 月 1 日に相当する datetime 値が返されます。これは、3 月の初めに 32 日が加算されると、4 月 1 日の値が得られるためです。day に小数部分が含まれる場合は、最も近い整数値に丸められます。 |
戻り値
指定された日付 (datetime) を返します。
解説
DATE 関数では、引数として入力された整数を受け取り、対応する日付を生成します。 DATE 関数は、年、月、および日を数式で指定する場合に最も役立ちます。 たとえば、基になるデータに、日付として認識されない形式の日付 (YYYYMMDD など) が含まれている場合があります。 DATE 関数を他の関数と組み合わせて使用すると、こうした日付を 1 つの日付として認識できる数値に変換できます。
日付をシリアル値として保存する Microsoft Excel とは対照的に、DAX の日付関数からは常に datetime データ型が返されます。 ただし、必要に応じて、書式設定を使用して日付をシリアル値として表示することもできます。
日付と時刻は、形式
dt"YYYY-MM-DD"、dt"YYYY-MM-DDThh:mm:ss"、またはdt"YYYY-MM-DD hh:mm:ss"でリテラルとして指定することもできます。 リテラルとして指定した場合、式で DATE 関数を使用する必要はありません。 詳細については、「DAX の構文 | 日付と時刻」を参照してください。この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。
例
単純な Date
次の数式では、2009 年 7 月 8 日が返されます。
= DATE(2009,7,8)
1899 より前の年
year 引数に入力した値が 0 (ゼロ) から 1899 (両方の値を含む) の場合、その値が 1900 に加算され、年が計算されます。 次の数式では 1908 年 1 月 2 日が返されます (1900+08)。
= DATE(08,1,2)
1899 より後の年
year が 1900 から 9999 (両方の値を含む) の場合、その値は年として使用されます。 次の数式からは 2008 年 1 月 2 日が返されます。
= DATE(2008,1,2)
Months
month が 12 より大きい場合、month により、指定した年の最初の月にその月数が加算されます。 次の数式では、2009 年 2 月 2 日が返されます。
= DATE(2008,14,2)
日間
day が指定した月の日数よりも大きい場合、day により、月の最初の日にその日数が加算されます。 次の数式では、2008 年 2 月 4 日が返されます。
= DATE(2008,1,35)