CUMULATE 関数は値を追加して数値を返します。デフォルトでは、時間軸全体に値が追加されます。リスト全体に値を追加することもできます。

CUMULATE (Values to add [, Boolean] [, List])

引数データ型説明
Values to add (必須)数値値を累積的に追加する数値ライン アイテム
ブール値ブール値値の累積のリセットに使用できるブール値引数
リスト 該当なし値を追加するアイテムのリスト

CUMULATE 関数は数値を返します。 

Classic で List 引数を指定する場合、リストを並べ替えたとしても、追加される値の順番は General Lists のリストの元の順番と同じになります。

Values to add 引数で使用する時間範囲は、結果ライン アイテムの時間範囲と一致させる必要があります。

Polaris:

  • 式集計方法を指定した状態で、ライン アイテムの式で CUMULATE を使用することはできません。Classic エンジンでは使用できます。
  • 式が適用されるライン アイテムのディメンションに List 引数を一致させる必要があります。Classic エンジンでは、ライン アイテム ディメンションのサブセットを List として使用することもできます。
  • General Lists の順序ではなく、正しい階層順が List 引数の順序になります。


以下の例では、数値形式の「Sales」ライン アイテムで一つのソース パラメーターとして CUMULATE を使用しています。複数の月にわたって「Sales」の値が追加されています。


Jan 12Feb 12Mar 12Apr12
Sales88,75387,45088,94586,523

Cumulative sales 

CUMULATE(Sales)

88,753 176,203265,148351,671

以下の二つ目の例ではブール値パラメーターを使用しています。ここでは「March」の「Sales」の累積計算をリセットしています。 


Jan 12Feb 12Mar 12Apr 12
Sales88,75387,45088,94586,523

Cumulative sales

CUMULATE(Sales)

88,753 176,20388,945 175,468
Reset Sales cumulate


以下の三つ目の例ではブール値パラメーターなしでリスト パラメーター「Sales Reps」を使用しています。このパラメーターは FALSE に設定されています。 


Edgar HarringtonJoe TippleHarry BoydeNicky Spinks
Sales88,75387,45088,94586,523

Cumulative sales 

CUMULATE(Sales, FALSE, Sales Reps)

88,753 176,203265,148351,671