MOVINGSUM 関数は、変化する時間範囲にわたる値の合計を返します。データの時間範囲が移動すると、更新された時間範囲で値を集計します。

週ごとの売上やパフォーマンス結果などの一連のデータに基づいて、ローリング合計やフォーキャストを作成する際にこの関数を使用します。

MOVINGSUM(Line item to aggregate [, Start offset] [, End offset] [, Aggregation method])

引数データ型説明
Line item to aggregate (必須)数値、ブール値、日付、リスト、又はテキスト

一定期間にわたって集計する値を含むライン アイテム。 

この引数はライン アイテムである必要があります。

Start offset 
数値

集計を開始する値。

Start offset を省略すると、時間範囲全体を対象に集計が実行されます。

End offset 
数値集計を終了する値。
Aggregation methodキーワード

使用する集計方法。

使用可能なキーワードは SUMAVERAGEMINMAXANYALLFIRSTNONBLANKLASTNONBLANKTEXTLIST です。

以下の「集計方法」のセクションにはさらに詳しい情報があります。

MOVINGSUM 関数は、Line item to aggregate のデータ型に一致する値を返します。

キーワードデータ型目的
SUM数値入力値を追加
AVERAGE数値入力値の平均を計算
MIN数値、日付最小入力値を特定
MAX数値、日付最大入力値を特定
ANYブール値TRUE である入力値があるかどうかを確認して、ある場合は TRUE を返します。
ALLブール値すべての入力値が TRUE であるかどうかを確認し、その場合は TRUE を返します。
FIRSTNONBLANK日付、リスト、テキスト最初の空白でない入力値を返す
LASTNONBLANK日付、リスト、テキスト最後の空白でない入力値を返す
TEXTLISTText入力値を「,」区切りで連結して単一のテキスト値を作成

Aggregation method を省略した場合、デフォルトの動作は Line item to aggregate のデータ型によって異なります。

  • Line item to aggregate のデータ型が数値の場合、デフォルトの方法は SUM です。
  • Line item to aggregate のデータ型がブール値の場合、デフォルトの方法は ANY です。
  • Line item to aggregate のデータ型が日付、リスト、又はテキストの場合、デフォルトの方法は FIRSTNONBLANK です。
動作PolarisClassic
二つの引数のバリアントMOVINGSUM(source, start)start オフセットに対応するポイントから時間ディメンションの終わりまでの source 値が集計されます。MOVINGSUM は、Start オフセットに対応するポイントの source の値を返します。
End offset の値が空白Start offsetに対応するポイントから時間範囲の終わりまでの source 値が集計されます。たとえば、ソースが月をディメンションとしている場合は 12 になります。End offset はデフォルトでは Start offset の値と同じになります。たとえば、MOVINSUM(source, 4)MOVINGSUM(source, 4, 4) とみなされます。
複数の時間範囲にまたがる参照複数の異なる時間範囲を参照できます。たとえば、MOVINGSUM では、ターゲット ライン アイテムの時間ディメンションとは異なる、時間ディメンションの時間範囲を基に Line item to aggregate を参照できます。複数の異なる時間範囲を参照できません。
複数のタイムスケールにまたがる参照ターゲットの時間ディメンションよりも粗いタイムスケールの時間ディメンションがあるソース ライン アイテムは参照できません。より粗い時間ディメンションがあるソース ライン アイテムを常に参照できます。
引数における NaN の処理Start offset 引数と End offset 引数のいずれかが NaN の場合、MOVINGSUM では Line item to aggregate のタイプのデフォルト値を返します。どちらかの引数の NaN は、時間ディメンションの最も早い期間に対応するオフセットとして扱われます。
空の集計の動作集計する値がない場合、つまり Start offsetEnd offset より大きい場合、MOVINGSUM では Line item to aggregate のタイプのデフォルト値を返します。
デフォルト値は、数値の場合は 0、ブール値の場合は False、その他のデータ型の場合は空白です。
使用される集計方法とそのデータ型の組み合わせに応じて値を返します。
日付の MIN 集計方法における空白の処理空白と空白でない日付値を比較する場合、MIN では空白が無視され、空白でない値が返されます。すべての値が空白の場合は空白が返されます。空白を空白でない日付値と比較すると、空白が返されます。
使用できない集計方法FIRSTNONBLANKLASTNONBLANKTEXTLIST は使用できません。すべての集計方法を使用できます。

 MOVINGSUM(Bonus, -2, 0)


Jan 22Feb 22Mar 22Apr 22May 22Jun 22Jul 22Aug 22
Bonus6,1505,8505,9006,0254,8504,9505,6006,250
MOVINGSUM
(Bonus, -2, 0)

6,150

12,000

17,900

17,775

16,775

15,825

15,400

16,800

たとえば、MOVINGSUM(source, -1, 0) で、Start offset (-1) 又は End offset (0) が Line item to aggregate の時間範囲外の値になる場合、範囲外の値は集計で無視されます。

Start offset 引数か End offset 引数に少数を使用する場合、MOVINGSUM では最も近い値に丸められる


Jan 23Feb 23Mar 23Apr 23May 23Jun 23Jul 23Aug 23Sep 23
Number200250300500400450200400350
Boolean
Date02/01/202306/02/202316/03/202320/04/202319/05/202323/06/202321/07/202330/08/202314/09/2023
MOVINGSUM(Number, -2, 0, AVERAGE)200225250350400450350350316.7
MOVINGSUM(Number, 1, 3, MAX)5005005004504504004003500
MOVINGSUM(Number, -4, 2, SUM)7501,2501,6502,1002,3002,5002,6002,3001,800
MOVINGSUM(Boolean, -1, 0, ANY)
IF MOVINGSUM(Boolean, -1, 0, ALL) THEN 1 ELSE 0001100110
MOVINGSUM(Date, -1, 0, MAX)06/02/202316/03/202320/04/202319/05/202323/06/202321/07/202330/08/202314/09/202314/09/2023