PREVIOUS 関数では、時間ディメンションの前の期間に基づいて式が評価されます。
たとえば、この関数を使用して、各期間の値を前の期間と相対的に比較できます。
構文
PREVIOUS(Expression)
引数
| 引数 | データ型 | 説明 |
| 式 | 数値、ブール値、日付、時間軸、リスト、又はテキスト | 前の期間の値を返す式 |
PREVIOUS 関数では Expression 引数と同じデータ型で結果が返されます (式が別のデータ型に解決される場合を除く)。
計算エンジンの機能の違い
Polaris では、式集計方法を指定した状態で、ライン アイテムの式で PREVIOUS を使用することはできません。Classic エンジンでは使用できます。
Classic エンジン:
- 時間ディメンションでのみ PREVIOUS 関数を使用できます。Polaris では、すべてのディメンションで PREVIOUS を使用できます。
- Expression 引数のデータ型がリストか時間軸で、別のデータ型に解決されない場合、結果ライン アイテムでデータ型を同じにする必要があります。
構文の例
PREVIOUS(Revenue)
この式では、「Revenue」ライン アイテムの各値について、前の期間の値が返されます。
追加情報
ライン アイテムの時間範囲外の値
PREVIOUS 関数でライン アイテムの時間範囲外の値が返された場合は、デフォルトの値が使用されます。ライン アイテムのデータ型ごとに NEXT が返す結果は以下のとおりです。
- データ型が数値の場合、値として 0 が返されます。
- データ型がブール値の場合、値として FALSE が返されます。
- データ型がテキスト、日付、又は時間軸の場合、値として BLANK が返されます。
値の繰越
ライン アイテムに繰越を適用すると、PREVIOUS 関数ではモジュールの最初の時間軸の前の追加期間として含まれます。ただし、繰越期間自体の前に値がないため、PREVIOUS 関数では繰越期間のデフォルト値が返されます。
制約
PREVIOUS 関数を使用する結果ライン アイテムでは、ディメンションとして時間を使用する必要があります。
例
Month on month profit change
| Jan 21 | Feb 21 | Mar 21 | Apr 21 | |
| Net Profit | 215,770 | 221,123 | 223,495 | 220,129 |
Month on month profit change
| 215,770 | 5,353 | 2,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」と同じになります。
