This documentation is archived and is not being maintained.

WorksheetFunction.NPer Method (Excel)

Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate.

expression .NPer(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

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.

Arg3

Required

Double

Pv - the present value, or the lump-sum amount that a series of future payments is worth right now.

Arg4

Optional

Variant

Fv - the future value, or a cash balance you want to attain after the last payment is made. If fv is omitted, it is assumed to be 0 (the future value of a loan, for example, is 0).

Arg5

Optional

Variant

Type - the number 0 or 1 and indicates when payments are due.

Return Value

Double

Set type equal to

If payments are due

0 or omitted

At the end of the period

1

At the beginning of the period

Show: