WorksheetFunction.Npv method (Excel)
Calculates the net present value of an investment by using a discount rate and a series of future payments (negative values) and income (positive values).
Syntax
expression.Npv (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6, Arg7, Arg8, Arg9, Arg10, Arg11, Arg12, Arg13, Arg14, Arg15, Arg16, Arg17, Arg18, Arg19, Arg20, Arg21, Arg22, Arg23, Arg24, Arg25, Arg26, Arg27, Arg28, Arg29, Arg30)
expression A variable that represents a WorksheetFunction object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| Arg1 | Required | Double | Rate - the rate of discount over the length of one period. |
| Arg2 - Arg30 | Required | Variant | Value1, value2, ... - 1 to 29 arguments representing the payments and income. |
Return value
Double
Remarks
Value1, value2, ... must be equally spaced in time and occur at the end of each period.
Npv uses the order of value1, value2, ... to interpret the order of cash flows. Be sure to enter your payment and income values in the correct sequence.
Arguments that are numbers, empty cells, logical values, or text representations of numbers are counted; arguments that are error values or text that cannot be translated into numbers are ignored.
If an argument is an array or reference, only numbers in that array or reference are counted. Empty cells, logical values, text, or error values in the array or reference are ignored.
The Npv investment begins one period before the date of the value1 cash flow and ends with the last cash flow in the list. The Npv calculation is based on future cash flows. If your first cash flow occurs at the beginning of the first period, the first value must be added to the Npv result, not included in the values arguments.
If n is the number of cash flows in the list of values, the formula for Npv is:
Npv is similar to the Pv function (present value). The primary difference between Pv and Npv is that Pv allows cash flows to begin either at the end or at the beginning of the period. Unlike the variable Npv cash flow values, Pv cash flows must be constant throughout the investment. For information about annuities and financial functions, see Pv.
Npv is also related to the Irr function (internal rate of return). Irr is the rate for which Npv equals zero: NPV(IRR(...), ...) = 0.
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.