PARALLELPERIOD
手記
この関数は、意味のない結果を返す可能性があるため、視覚的な計算
現在のコンテキストで、指定した dates 列の日付と平行な期間を表す日付の列を含むテーブルを返します。日付は、時間単位または時間単位で複数の間隔をシフトします。
構文
PARALLELPERIOD(<dates>,<number_of_intervals>,<interval>)
パラメーター
| 用語 | 定義 |
|---|---|
dates |
日付を含む列。 |
number_of_intervals |
日付に加算または減算する間隔の数を指定する整数。 |
interval |
日付をシフトする間隔。 間隔の値には、year、quarter、monthのいずれかを指定できます。 |
戻り値
日付値の単一列を含むテーブル。
備考
この関数は、
datesで指定された列の現在の日付セットを受け取り、指定した間隔の最初の日付と最後の日付をシフトし、2 つのシフトされた日付の間のすべての連続した日付を返します。 間隔が月、四半期、または年の部分的な範囲である場合は、結果の部分的な月も入力され、間隔全体が完了します。dates引数には、次のいずれかを指定できます。- 日付/時刻列への参照。
- 日付/時刻値の単一列を返すテーブル式。
- 日付/時刻値の単一列テーブルを定義するブール式。
ブール式に対する制約については、関数
トピックで説明します。 number_of_intervalsに指定された数値が正の場合、datesの日付は時間内に移動されます。数値が負の場合、datesの日付は時間単位でシフトされます。intervalパラメーターは列挙体であり、文字列のセットではありません。したがって、値を引用符で囲む必要はありません。 また、year、quarter、monthの値は、それらを使用するときに完全にスペルする必要があります。結果テーブルには、基になるテーブル列の値に表示される日付のみが含まれます。
PARALLELPERIOD 関数は DATEADD 関数に似ていますが、PARALLELPERIOD は常に、DATEADD が返す部分期間ではなく、特定の粒度レベルで完全な期間を返します。 たとえば、6 月 10 日から同じ年の 6 月 21 日に終了する日付の選択があり、その選択を 1 か月進める場合、PARALLELPERIOD 関数は翌月 (7 月 1 日から 7 月 31 日) のすべての日付を返します。ただし、代わりに DATEADD が使用されている場合、結果には 7 月 10 日から 7 月 21 日までの日付のみが含まれます。
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
次のサンプル数式では、インターネット販売の前年の売上を計算するメジャーを作成します。
= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PARALLELPERIOD(DateTime[DateKey],-1,year))