Financial.Rate(Double, Double, Double, Double, DueDate, Double) Methode

Definitie

Naamruimte:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Bron:
Financial.vb
Bron:
Financial.vb
Bron:
Financial.vb
Bron:
Financial.vb
Bron:
Financial.vb

Retourneert een waarde die het rentepercentage per periode voor een annuïteit aangeeft.

public static double Rate(double NPer, double Pmt, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod, double Guess = 0.1);
static member Rate : double * double * double * double * Microsoft.VisualBasic.DueDate * double -> double
Public Function Rate (NPer As Double, Pmt As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod, Optional Guess As Double = 0.1) As Double

Parameters

NPer
Double

Verplicht. Het totale aantal betalingsperioden in de annuïteit. Als u bijvoorbeeld per maand betaalt voor een autolening van vier jaar, omvat uw lening in totaal 4 * 12 (oftewel 48) betalingsperioden.

Pmt
Double

Verplicht. De betaling die elke periode moet worden verricht. Betalingen bestaan meestal uit een bedrag aan aflossing en rente dat niet verandert gedurende de looptijd van de annuïteit.

PV
Double

Verplicht. De huidige waarde, of de huidige waarde, van een reeks toekomstige betalingen of ontvangsten. Wanneer u bijvoorbeeld geld leent om een auto te kopen, is het geleende bedrag de huidige waarde voor de verstrekker van de lening.

FV
Double

Optional. De toekomstige waarde of het gewenste saldo nadat u de laatste betaling hebt uitgevoerd. De toekomstige waarde van een lening is bijvoorbeeld \$0 omdat dat de waarde is na de laatste betaling. Als u echter \$50.000 meer dan 18 jaar wilt besparen voor het onderwijs van uw kind, is \$50.000 de toekomstige waarde. Als dit argument wordt weggelaten, wordt 0 als standaardwaarde gebruikt.

Due
DueDate

Optional. Object van het type DueDate dat aangeeft wanneer betalingen verschuldigd zijn. Dit argument moet zijn DueDate.EndOfPeriod als betalingen aan het einde van de betalingsperiode moeten worden voldaan of DueDate.BegOfPeriod als betalingen aan het begin van de periode moeten worden voldaan. Als u dit weglaat, DueDate.EndOfPeriod wordt ervan uitgegaan.

Guess
Double

Optional. De waarde die u schat, wordt geretourneerd door Rate. Als u dit weglaat, Guess is dit 0,1 (10 procent).

Retouren

Double

Het rentepercentage per periode voor een annuïteit.

Uitzonderingen

ArgumentException

NPer <= 0.

Voorbeelden

In dit voorbeeld wordt de Rate functie gebruikt om het rentepercentage van een lening te berekenen op basis van het totale aantal betalingen (TotPmts), het bedrag van de leningbetaling (Payment), de huidige waarde of hoofdsom van de lening (), de toekomstige waarde van de lening (PVal), een getal dat aangeeft of de betaling aan het begin of einde van de betalingsperiode moetFVal worden voldaan (PayType), en een benadering van het verwachte rentepercentage (Guess).

Sub TestRate()
    Dim PVal, Payment, TotPmts, APR As Double
    Dim PayType As DueDate

    ' Define percentage format.
    Dim Fmt As String = "##0.00"
    Dim Response As MsgBoxResult
    ' Usually 0 for a loan.
    Dim FVal As Double = 0
    ' Guess of 10 percent.
    Dim Guess As Double = 0.1
    PVal = CDbl(InputBox("How much did you borrow?"))
    Payment = CDbl(InputBox("What's your monthly payment?"))
    TotPmts = CDbl(InputBox("How many monthly payments do you have to make?"))
    Response = MsgBox("Do you make payments at the end of the month?", MsgBoxStyle.YesNo)
    If Response = MsgBoxResult.No Then
        PayType = DueDate.BegOfPeriod
    Else
        PayType = DueDate.EndOfPeriod
    End If
    APR = (Rate(TotPmts, -Payment, PVal, FVal, PayType, Guess) * 12) * 100

    MsgBox("Your interest rate is " & Format(CInt(APR), Fmt) & " percent.")
End Sub

Opmerkingen

Een annuïteit is een reeks vaste contante betalingen gedurende een specifieke periode. Een annuïteit kan een lening zijn (bijvoorbeeld een hypotheek) of een investering (bijvoorbeeld een maandelijks spaarplan).

Voor alle argumenten worden betaalde bedragen (zoals stortingen op een spaarrekening) weergegeven als negatieve getallen, terwijl ontvangen bedragen (zoals dividenden) worden weergegeven als positieve getallen.

Rate wordt berekend door iteratie. Vanaf de waarde van Guess, Rate doorloopt de berekening totdat het resultaat binnen 0,00001 procent nauwkeurig is. Als Rate er na 20 pogingen geen resultaat kan worden gevonden, mislukt het. Als uw schatting 10 procent is en Rate mislukt, probeert u een andere waarde voor Guess.

Van toepassing op

Zie ook