TOTALYTD
Note
この関数は、意味のない結果を返す可能性が高いため、ビジュアル計算で使用することは推奨されません。
現在のコンテキストの expression
の年累計値を評価します。
構文
TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])
パラメーター
パラメーター | 定義 |
---|---|
expression |
スカラー値を返す式。 |
dates |
日付を含む列。 |
filter |
(省略可能)現在のコンテキストに適用するフィルターを指定する式。 |
year_end_date |
(省略可能)年の終了日を定義する日付を含むリテラル文字列。 既定値は 12 月 31 日です。 |
戻り値
現在の年累計 dates
に対して評価された expression
を表すスカラー値。
解説
dates
引数には、次のいずれかを指定できます。- 日付/時刻列への参照。
- 日付/時刻値の単一列を返すテーブル式。
- 日付/時刻値の単一列テーブルを定義するブール式。
ブール式に対する制約については、「CALCULATE」を参照してください。
filter
式には、トピック「CALCULATE」で説明されている制限があります。year_end_date
パラメーターは、ブックが作成されたクライアントのロケールと同じロケールの日付の文字列リテラルです。 日付の年部分は必須ではなく、無視されます。 たとえば、次の数式では、EN-US ロケール ブックに 6/30 の (会計年度) year_end_date が指定されます。= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey], ALL('DateTime'), "6/30")
この例では、year_end_dateは"6/30"、"Jun 30"、"30 June"、または月/日に解決される任意の文字列として指定できます。 ただし、文字列が日付に確実に解決されるように、"月/日" を使用してyear_end_dateを指定することをお勧めします (次に示すように)。
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
次のサンプル数式では、インターネット販売の "年間累計" または "年間実行合計" を計算するメジャーを作成します。
= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])