RATE

RATE(nper, pmt, pv [,fv] [,type] [,guess])

Returns the interest rate for a series of equal cash flows at regular intervals (Double).


nperThe total number of payment periods in the annuity (Double).
pmtThe payment to be made each period (Double).
pvThe present value of a series of future payments or receipts (Double).
fv(Optional) The future value you want after you make the final payment (Double).
type(Optional) The number indicating when the payments are due:
0 = the end of the period (default)
1 = the start of the period
guess(Optional) The value you estimate will be returned by this function (Variant).

REMARKS
* An annuity is a series of fixed cash payments made over a period of time.
* An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
* For example, if you make monthly payments on a four-year car loan, your loan has a total of 4 * 12 (or 48) payment periods.
* Payments usually contain principal and interest that doesn't change over the life of the annuity.
* If "fv" is left blank, then 0 is used.
* If "type" = True, then 1 is used.
* If "guess" is left blank, then 0.1 (10 percent) is used.
* For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
* Rate is calculated by iteration. Starting with the value of guess, Rate cycles through the calculation until the result is accurate to within 0.00001 percent.
* If Rate can't find a result after 20 tries, it fails. If your guess is 10 percent and Rate fails, try a different value for guess.
* For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.
* For example, the future value of a loan is $0 because that's its value after the final payment. However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value.
* You can use the FV function to return the future value of a series of equal cash flows at regular intervals.
* You can use the IRR function to return the interest rate for a series of unequal cash flows at regular intervals (implicit reinvestment rate).
* You can use the MIRR function to return the internal rate of return for a series of unequal cash flows at regular intervals (explicit reinvestment rate).
* You can use the PMT function to return the amount of principal and interest paid in a given period in a series of equal cash flows at regular intervals.
* You can use the PV function to return the present value of a series of equal cash flows at regular intervals.
* The equivalent Excel function is Application.WorksheetFunction.RATE
* The equivalent .NET function is Microsoft.VisualBasic.Financial.Rate
* For the Microsoft documentation refer to learn.microsoft.com

Debug.Print Rate(24,-2000,12000)               '= 0.162141523814308  
Debug.Print Rate(24,-2000,12000,0) '= 0.162141523814308
Debug.Print Rate(24,-2000,12000,0,False) '= 0.162141523814308
Debug.Print Rate(24,-2000,12000,0,False,0.1) '= 0.162141523814308
Debug.Print Rate(24,2000,12000) '= COMPILE ERROR

© 2024 Better Solutions Limited. All Rights Reserved. © 2024 Better Solutions Limited Top