DATESINPERIOD 関数

start_date から始まり、指定された number_of_intervals が表す長さの期間に含まれる日付の列を含むテーブルを返します。

構文

DATESINPERIOD(<dates>,<start_date>,<number_of_intervals>,<interval>)

パラメーター

項目

定義

dates

日付が格納されている列。

start_date

日付の式。

number_of_intervals

日付に加算または日付から減算する間隔の数を示す整数。

interval

日付をシフトする間隔。 間隔の値には、year、quarter、month、day のいずれかを指定できます。

戻り値

日付値の単一列から成るテーブル。

説明

注意

コンテキストが数式の結果に与える影響の詳細については、「DAX の数式のコンテキスト」を参照してください。

dates 引数には、次のいずれかを指定できます。

  • 日付/時刻列への参照。

  • 日付/時刻値の単一列を返すテーブル式。

  • 日付/時刻値の単一列テーブルを定義するブール式。

注意

ブール式の制約の詳細については、「CALCULATE 関数」を参照してください。

number_of_intervals に指定された数値が正の値の場合、日付は時間的に進められます。負の値の場合、日付は時間的に戻ります。

interval パラメーターは、文字列のセットではなく列挙値です。そのため、値を引用符で囲まないでください。 また、year、quarter、month、および day の値を使用する際にはフル スペルで記述してください。

結果のテーブルに含まれるのは、内在するテーブル列の値として格納されている日付のみです。

この DAX 関数は DirectQuery モードでは使用できません。 DirectQuery モデルの制限の詳細については、https://go.microsoft.com/fwlink/?LinkId=219172 を参照してください。

使用例

次の数式は、2007 年 8 月 24 日までの 21 日間のインターネット販売の売上を返します。

= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]),DATESINPERIOD(DateTime[DateKey],DATE(2007,08,24),-21,day))

関連項目

参照

DATESBETWEEN 関数

その他の技術情報

タイム インテリジェンス関数 (DAX)

日付と時刻の関数 (DAX)

サンプル データの入手