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

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.Core.dll
Zestaw:
Microsoft.VisualBasic.dll

Zwraca wartość określającą stopę procentową na okres renty.

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

Parametry

NPer
Double

Wymagane. Łączna liczba okresów płatności w rentie. Jeśli na przykład dokonasz miesięcznych płatności na czteroletnią pożyczkę samochodową, pożyczka ma łącznie 4 * 12 (lub 48) okresów płatności.

Pmt
Double

Wymagane. Płatność, która ma być dokonana w każdym okresie. Płatności zwykle zawierają kapitał i odsetki, które nie zmieniają się w ciągu życia renty.

PV
Double

Wymagane. Wartość bieżąca lub wartość bieżąca serii przyszłych płatności lub wpływów. Na przykład przy zaciągnięciu kredytu na zakup samochodu kwota kredytu stanowi dla kredytodawcy wartość bieżącą miesięcznych płatności za samochód, których będziesz dokonywać.

FV
Double

Opcjonalny. Przyszła wartość lub saldo gotówkowe, które chcesz wykonać po dokonaniu ostatecznej płatności. Na przykład przyszła wartość kredytu wynosi 0 zł, ponieważ taka będzie jego wartość po ostatniej płatności. Jeśli jednak chcesz zaoszczędzić 50 000 zł przez 18 lat na wykształcenie dziecka, 50 000 zł jest wartością przyszłą. W przypadku pominięcia przyjmowana jest wartość 0.

Due
DueDate

Opcjonalny. Obiekt typu DueDate , który określa, kiedy płatności są należne. Ten argument musi być albo DueDate.EndOfPeriod , jeśli płatności są należne na koniec okresu płatności, lub DueDate.BegOfPeriod , jeśli płatności są należne na początku okresu. W przypadku pominięcia przyjmowana jest wartość DueDate.EndOfPeriod .

Guess
Double

Opcjonalny. Szacowana wartość jest zwracana przez Rateelement . W przypadku pominięcia Guess wartość wynosi 0,1 (10 procent).

Zwraca

Double

Stopa procentowa na okres renty.

Wyjątki

ArgumentException

NPer<= 0.

Przykłady

W tym przykładzie Rate użyto funkcji do obliczenia stopy procentowej pożyczki, biorąc pod uwagę całkowitą liczbę płatności (TotPmts), kwotę płatności pożyczki (Payment), wartość bieżącą lub kapitał pożyczki (), przyszłą wartość pożyczki (PVal``FVal), liczbę wskazującą, czy płatność jest należna na początku lub na końcu okresu płatności (PayType), oraz przybliżenie oczekiwanej stopy procentowej (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

Uwagi

Renta to szereg stałych płatności gotówkowych dokonywanych w pewnym okresie. Renta może mieć charakter kredytu/pożyczki (np. kredyt hipoteczny) lub inwestycji (np. miesięczny plan oszczędzania).

W przypadku wszystkich argumentów środki wypłacane (na przykład wpłacane na rachunek oszczędnościowy) są wyrażone liczbami ujemnymi, a środki pieniężne otrzymane (na przykład dywidendy) są wyrażone liczbami dodatnimi.

Rate jest obliczany przez iterację. Począwszy od wartości Guess, Rate przechodzi przez obliczenie, aż wynik będzie dokładny do 0,00001 procent. Jeśli Rate nie można odnaleźć wyniku po 20 próbach, kończy się niepowodzeniem. Jeśli zgadywanie wynosi 10 procent i Rate kończy się niepowodzeniem, spróbuj użyć innej wartości dla elementu Guess.

Dotyczy

Zobacz też