PREVIOUSYEAR
Note
この関数は、意味のない結果を返す可能性が高いため、ビジュアル計算で使用することは推奨されません。
現在のコンテキストで、dates 列内の最後の日付に基づいて、前年のすべての日付の列を含むテーブルを返します。
構文
PREVIOUSYEAR(<dates>[,<year_end_date>])
パラメーター
用語 | 定義 |
---|---|
dates | 日付を含む列。 |
year_end_date | (省略可能) 年度末の日付を定義する日付を含むリテラル文字列。 既定値は 12 月 31 日です。 |
戻り値
日付値の単一列を含むテーブル。
解説
この関数では、入力パラメーターに最後の日付を指定すると、前年のすべての日付が返されます。 たとえば、dates 引数の最後の日付が 2009 年を指している場合、この関数からは、指定した year_end_date までの、2008 年のすべての日付が返されます。
dates 引数には、次のいずれかを指定できます。
- 日付/時刻列への参照。
- 日付/時刻の値の単一の列を返すテーブル式。
- 日付/時刻の値の単一列テーブルを定義するブール式。
ブール式の制約の詳細については、トピック「CALCULATE」を参照してください。
year_end_date パラメーターは日付の文字列リテラルで、ロケールはブックが作成されたクライアントのロケールと同じです。 日付の年の部分は無視されます。
この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。
例
次のサンプルの数式では、インターネット販売の前年の売上を計算するメジャーを作成します。
= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PREVIOUSYEAR('DateTime'[DateKey]))
関連するコンテンツ
タイム インテリジェンス関数
日付と時刻関数
PREVIOUSMONTH
PREVIOUSDAY
PREVIOUSQUARTER