XNPV() returns the aggregated net present value for a schedule of cash flows (not necessarily periodic) represented by paired numbers in the expressions given by pmt and date iterated over the chart dimensions. All payments are discounted based on a 365-day year.
Syntax:
XNPV([TOTAL [<fld{,fld}>]] discount_rate, pmt, date)
Return data type: numeric By default, the result will be formatted as currency.
Arguments:
| Argument | Description |
|---|---|
| discount_rate | discount_rate is the rate of discount over the length of the period.discount_rate is the percentage rate of discount applied. |
| pmt | Payments.The expression or field containing the cash flows corresponding to the payment schedule given in date. |
| date | The expression or field containing the schedule of dates corresponding to the cash flow payments given in pmt. |
| TOTAL |
If the word TOTAL occurs before the function arguments, the calculation is made over all possible values given the current selections, and not just those that pertain to the current dimensional value, that is, it disregards the chart dimensions. By using TOTAL [<fld {.fld}>], where the TOTAL qualifier is followed by a list of one or more field names as a subset of the chart dimension variables, you create a subset of the total possible values. |
Limitations:
discount_rate, pmt and date must not contain aggregation functions, unless these inner aggregations contain the TOTAL or ALL qualifiers. For more advanced nested aggregations, use the advanced function Aggr, in combination with a specified dimension.
Text values, NULL values and missing values in any or both pieces of a data-pair result in the entire data-pair being disregarded.
Examples and results:
| Example | Result |
|---|---|
| XNPV(Discount, Payments, Date) | -$3164.35 |
Data used in examples:
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 '|');