# NPV - 圖表函數

NPV() 會根據圖表維度上反覆運算的數字 (以 value 表示) 代表的各期間的 discount\_rate 以及一系列未來支出 (負值) 和收入 (正值)，傳回投資的彙總淨現值。支出與收入假設於每個期間的末尾發生。

語法：

NPV([TOTAL [<fld {,fld}>]] discount\_rate, value)

傳回的資料類型： 數值 依照預設，結果將會格式化為貨幣。

引數：

引數

| 引數 | 描述 |
| --- | --- |
| discount\_rate | discount\_rate 是套用的折扣百分比。 |
| value | 包含待測量之資料的運算式或欄位。 |
| TOTAL | 如果單字 TOTAL 位於函數引數之前，則會在提供現行選項的所有可能值上進行計算，而不僅僅是關於目前維度值的那些選項，也就是說，它會忽略圖表維度。<br><br>透過使用 TOTAL [&lt;fld {.fld}&gt;] (其中 TOTAL 限定詞後面是做為圖表維度變數子集之一或更多欄位名稱的清單)，您可建立總可能值的子集。<br><br>[定義彙總範圍](https://help.qlik.com/zh-TW/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm)<br><br>TOTAL 限定詞後面可以加上以角括弧括住的一或多個欄位名稱清單。這些欄位名稱應該是圖表維度變數的子集。在這種情況下，將忽略所列圖表維度變數以外的所有圖表維度變數進行計算，也就是說，將對於所列維度欄位中欄位值的各個組合傳回一個值。另外，清單可以包含目前在圖表中並不是維度的欄位。對於維度欄位不固定的群組維度而言，這會相當實用。列出群組的所有變數會使得函數在向下探查層級變更時產生作用。 |

限制：

除非內部彙總包含 TOTAL 限定詞，否則 discount\_rate 與 value 不可包含彙總函數。 如需更進階的巢狀彙總，請結合使用進階函數 Aggr 與指定維度。

文字值、NULL 值和遺漏值將予以忽略。

範例與結果：

範例與結果

| 範例 | 結果 |
| --- | --- |
| `NPV(Discount, Payments)` | -$540.12 |

範例中使用的資料：

`Cashflow:` `LOAD 2013 as Year, * inline [` `Date|Discount|Payments` `2013-01-01|0.1|-10000` `2013-03-01|0.1|3000` `2013-10-30|0.1|4200` `2014-02-01|0.2|6800` `] (delimiter is '|');`

## 瞭解更多資訊

* [XNPV - 圖表函數](https://help.qlik.com/zh-TW/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FinancialAggregationFunctionsInCharts/xnpv.htm)
* [Aggr - 圖表函數](https://help.qlik.com/zh-TW/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/aggr.htm)