WorksheetFunction.Fv method (Excel)
Returns the future value of an investment based on periodic, constant payments and a constant interest rate.
Syntax
expression.Fv (Arg1, Arg2, Arg3, Arg4, Arg5)
expression A variable that represents a WorksheetFunction object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| Arg1 | Required | Double | Rate - the interest rate per period. |
| Arg2 | Required | Double | Nper - the total number of payment periods in an annuity. |
| Arg3 | Required | Double | Pmt - the payment made each period; it cannot change over the life of the annuity. Typically, pmt contains principal and interest but no other fees or taxes. If pmt is omitted, you must include the pv argument. |
| Arg4 | Optional | Variant | Pv - the present value, or the lump-sum amount that a series of future payments is worth right now. If pv is omitted, it is assumed to be 0 (zero), and you must include the pmt argument. |
| Arg5 | Optional | Variant | Type - the number 0 or 1 and indicates when payments are due. If type is omitted, it is assumed to be 0. |
Return value
Double
Remarks
For a more complete description of the arguments in Fv and for more information about annuity functions, see Pv.
The following table describes the values that can be used for Arg5.
| Set type equal to | If payments are due |
|---|---|
| 0 | At the end of the period |
| 1 | At the beginning of the period |
Make sure that you are consistent about the units you use for specifying rate and nper. If you make monthly payments on a four-year loan at 12 percent annual interest, use 12%/12 for rate and 4*12 for nper. If you make annual payments on the same loan, use 12% for rate and 4 for nper.
For all the arguments, cash you pay out, such as deposits to savings, is represented by negative numbers; cash you receive, such as dividend checks, is represented by positive numbers.
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.