PREVIOUS 関数では、時間ディメンションの前の期間に基づいて式が評価されます。

たとえば、この関数を使用して、各期間の値を前の期間と相対的に比較できます。

PREVIOUS(Expression)

引数データ型説明
数値、ブール値、日付、時間軸、リスト、又はテキスト前の期間の値を返す式

PREVIOUS 関数では Expression 引数と同じデータ型で結果が返されます (式が別のデータ型に解決される場合を除く)。

Polaris では、式集計方法を指定した状態で、ライン アイテムの式で PREVIOUS を使用することはできません。Classic エンジンでは使用できます。

Classic エンジン:

  • 時間ディメンションでのみ PREVIOUS 関数を使用できます。Polaris では、すべてのディメンションで PREVIOUS を使用できます。
  • Expression 引数のデータ型がリストか時間軸で、別のデータ型に解決されない場合、結果ライン アイテムでデータ型を同じにする必要があります。

PREVIOUS(Revenue)

この式では、「Revenue」ライン アイテムの各値について、前の期間の値が返されます。

PREVIOUS 関数でライン アイテムの時間範囲外の値が返された場合は、デフォルトの値が使用されます。ライン アイテムのデータ型ごとに NEXT が返す結果は以下のとおりです。

  • データ型が数値の場合、値として 0 が返されます。
  • データ型がブール値の場合、値として FALSE が返されます。
  • データ型がテキスト、日付、又は時間軸の場合、値として BLANK が返されます。

ライン アイテムに繰越を適用すると、PREVIOUS 関数ではモジュールの最初の時間軸の前の追加期間として含まれます。ただし、繰越期間自体の前に値がないため、PREVIOUS 関数では繰越期間のデフォルト値が返されます。

PREVIOUS 関数を使用する結果ライン アイテムでは、ディメンションとして時間を使用する必要があります。


Jan 21Feb 21Mar 21Apr 21
Net Profit215,770221,123223,495220,129

Month on month profit change

Net Profit - PREVIOUS(Net Profit)

215,7705,3532,372-3,366

こちらの例では、損益計算書モジュールの行にライン アイテム、列に時間があります。「Net Profit」ライン アイテムには、ある企業の純利益が表示されています。

Month on month profit change」ライン アイテムの式では、PREVIOUS 関数を使用して前の期間から「Net Profit」の値を取得しています。前の期間の「Net Profit」が現在の期間の「Net Profit」から差し引かれ、ある月から次の月までの利益の変化が計算されます。モジュールの時間範囲は 2021 年に開始されるため、「Jan 21」の「Month on month profit change」の値は「Net Profit」と同じになります。