Skip to main content

XNPV - script function

XNPV() returns the aggregated net present value for a schedule of cashflows (not necessarily periodic) represented by paired numbers in pmt and date, iterated over a number of records as defined by a group by clause. Rate is the interest rate per period. All payments are discounted based on a 365-day year.

Syntax:  

XNPV(discount_rate, pmt, date)

Return data type: numeric. The result has a default number format of money. .

Arguments:  

  • pmt: The expression or field containing the data to be measured.
  • date: The expression or field containing the schedule of dates corresponding to the cash flow payments given in pmt.
  • discount_rate: discount_rate is the rate of discount over the length of the period.

Limitations:  

Text values, NULL values and missing values in any or both pieces of a data-pair will result in the entire data-pair to be disregarded.

Examples and results:  

Add the example script to your document and run it. Then add, at least, the fields listed in the results column to a sheet in your document to see the result.

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 '|');

 

Cashflow1:

LOAD Year,XNPV(0.2, Payments, Date) as XNPV1_2013 Resident Cashflow Group By Year;

Example results
Year XNPV1_2013

2013

$2104.37

Given that the Cashflow table is loaded as in the previous example:

LOAD Year,XNPV(Discount, Payments, Date) as XNPV2_2013 Resident Cashflow Group By Year, Discount;

Example results
Year Discount XNPV2_2013
2013 0.1 -$3164.35

2013

0.2

$6800.00