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