WEEKVALUE 関数は別のライン アイテムを参照し、その週内の各時間軸の週次時間集計値を返します。この関数は、期間の個々の値を対応する週次集計に置き換えます。
たとえば、WEEKVALUE 関数を使って、ある週のなかで平均を下回る日次売上を特定できます。
構文
WEEKVALUE(Line item)
引数
| 引数 | データ型 | 説明 |
| Line item | 数字、ブール値、日付、時間軸、リスト、テキスト | 1 週間の時間集計値を参照するライン アイテム |
WEEKVALUE 関数は参照するライン アイテムと同じデータ型の結果を返します。
計算エンジンの機能の違い
Polaris では、WEEKVALUE 関数より大きいタイム スケールで結果ライン アイテムに WEEKVALUE 関数を使用することはできません。
Classic エンジンではこの場合に値 0 が返されます。
制約
- WEEKVALUE 関数を含むライン アイテムでは、[Time Scale] を [Day] か [Week] に設定する必要があります。
- カレンダー タイプが週に基づいているモデルでしか WEEKVALUE 関数は使用できません。
例
週平均を上回る売上があった日
こちらの例では、「Product sales」モジュールの行にライン アイテム、列に時間があります。
- 「Daily sales」ライン アイテムと「Weekly sales」ライン アイテムのデータ型は数値です。
- 「Day below average for week」ライン アイテムのデータ型はブール値です。
ブループリント ビューでは、「Daily sales」の [Summary] 列の [Time Summary] が [Average] に設定されています。「Weekly sales」の式は、曜日ごとの週次集計平均を返します。「Day below average for week」の式は、各曜日の平均値を下回る値に対して TRUE の結果を返します。
| 4 Jan 21 | 5 Jan 21 | 6 Jan 21 | 7 Jan 21 | 8 Jan 21 | 9 Jan 21 | 10 Jan 21 | |
| Daily sales | 200 | 254 | 122 | 543 | 233 | 350 | 431 |
Weekly salesWEEKVALUE(Daily sales) | 304.71 | 304.71 | 304.71 | 304.71 | 304.71 | 304.71 | 304.71 |
Day below average for weekDaily sales < WEEKVALUE(Daily sales) |