CUMULATE 関数は値を追加して数値を返します。デフォルトでは、時間軸全体に値が追加されます。リスト全体に値を追加することもできます。
構文
CUMULATE (Values to add [, Boolean] [, List])
引数
引数 | データ型 | 説明 |
Values to add (必須) | 数値 | 値を累積的に追加する数値ライン アイテム |
ブール値 | ブール値 | 値の累積のリセットに使用できるブール値引数 |
リスト | 該当なし | 値を追加するアイテムのリスト |
CUMULATE 関数は数値を返します。
計算エンジンの機能の違い
Polaris:
- 式集計方法を指定した状態で、ライン アイテムの式で CUMULATE を使用することはできません。Classic エンジンでは使用できます。
- 式が適用されるライン アイテムのディメンションに List 引数を一致させる必要があります。Classic エンジンでは、ライン アイテム ディメンションのサブセットを List として使用することもできます。
- General Lists の順序ではなく、正しい階層順が List 引数の順序になります。
制約
List 引数の順番
Classic で List 引数を指定する場合、リストを並べ替えたとしても、追加される値の順番は General Lists のリストの元の順番と同じになります。
時間範囲の要件
Values to add 引数で使用する時間範囲は、結果ライン アイテムの時間範囲と一致させる必要があります。
例
以下の例では、数値形式の「Sales」ライン アイテムで一つのソース パラメーターとして CUMULATE を使用しています。複数の月にわたって「Sales」の値が追加されています。
Jan 12 | Feb 12 | Mar 12 | Apr12 | |
Sales | 88,753 | 87,450 | 88,945 | 86,523 |
Cumulative sales
| 88,753 | 176,203 | 265,148 | 351,671 |
以下の二つ目の例ではブール値パラメーターを使用しています。ここでは「March」の「Sales」の累積計算をリセットしています。
Jan 12 | Feb 12 | Mar 12 | Apr 12 | |
Sales | 88,753 | 87,450 | 88,945 | 86,523 |
Cumulative sales
| 88,753 | 176,203 | 88,945 | 175,468 |
Reset Sales cumulate |
以下の三つ目の例ではブール値パラメーターなしでリスト パラメーター「Sales Reps」を使用しています。このパラメーターは FALSE に設定されています。
Edgar Harrington | Joe Tipple | Harry Boyde | Nicky Spinks | |
Sales | 88,753 | 87,450 | 88,945 | 86,523 |
Cumulative sales
| 88,753 | 176,203 | 265,148 | 351,671 |