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

Definition

Returnerar ett värde som anger räntesatsen per period för en livränta.

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

Parametrar

NPer
Double

Required. Det totala antalet betalningsperioder i annuiteten. Om du till exempel gör månatliga inbetalningar på ett fyraårigt lån, har lånet totalt 4 gånger 12 (alltså 48) betalningsperioder.

Pmt
Double

Required. Den betalning som ska göras varje period. Betalningarna innehåller vanligen kapital och ränta som inte ändras under löptiden för ett annuitetslån.

PV
Double

Required. Nuvärdet, eller värdet i dag, för en serie framtida betalningar eller kvitton. När du till exempel lånar pengar för att köpa en bil är lånebeloppet det nuvarande värdet för långivaren av de månatliga bilbetalningar du kommer att göra.

FV
Double

Optional. Det framtida värde eller det kontantsaldo som du vill ha när du har slutfört betalningen. Till exempel är det framtida värdet för ett lån \$0 eftersom det är dess värde efter den slutliga betalningen. Men om du vill spara \$50 000 över 18 år för ditt barns utbildning är \$50 000 det framtida värdet. Om inget värde anges används automatiskt värdet 0.

Due
DueDate

Optional. Objekt av typen DueDate som anger när betalningar förfaller. Det här argumentet måste vara antingen DueDate.EndOfPeriod om betalningarna förfaller i slutet av betalningsperioden eller DueDate.BegOfPeriod om betalningarna förfaller i början av perioden. Om det utelämnas DueDate.EndOfPeriod antas det.

Guess
Double

Optional. Värdet som du uppskattar returneras av Rate. Om det utelämnas Guess är 0,1 (10 procent).

Returer

Räntesatsen per period för en livränta.

Undantag

NPer <= 0.

Exempel

I det Rate här exemplet används funktionen för att beräkna räntesatsen för ett lån med tanke på det totala antalet betalningar (TotPmts), lånebeloppet (Payment), lånets nuvärde eller kapitalbelopp (PVal), lånets framtida värde (FVal), ett tal som anger om betalningen förfaller i början eller slutet av betalningsperioden (PayType), och en uppskattning av den förväntade räntan (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

Kommentarer

En annuitet är en serie konstanta betalningar över en sammanhängande period. En annuitet kan vara ett lån (t.ex. ett huslån) eller en investering (t.ex. en plan för månatligt sparande).

För alla argument gäller att de betalningar du gör, t ex inbetalningar på sparkonto, representeras av negativa tal och pengar som du tar emot, t ex återbäring, representeras av positiva tal.

Rate beräknas med iteration. Från och med värdet för Guess, Rate växlar genom beräkningen tills resultatet är korrekt till inom 0,00001 procent. Om Rate det inte går att hitta ett resultat efter 20 försök misslyckas det. Om din gissning är 10 procent och Rate misslyckas kan du prova ett annat värde för Guess.

Gäller för

Se även