Udostępnij za pośrednictwem

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
Źródło:
Financial.vb
Źródło:
Financial.vb
Źródło:
Financial.vb

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 zostać wykonana 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. Bieżąca wartość lub wartość serii przyszłych płatności lub paragonó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. Wartość przyszła 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 wtedy, gdy 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 DueDate.EndOfPeriod przyjmuje się założenie.

Guess
Double

Opcjonalny. Szacowana wartość jest zwracana przez Rate. Jeśli pominięto, Guess wynosi 0,1 (10 procent).

Zwraca

Double

Stopa procentowa na okres renty.

Wyjątki

ArgumentException

NPer<= 0.

Przykłady

W tym przykładzie użyto Rate funkcji do obliczenia stopy procentowej pożyczki podanej całkowitej liczby płatności (TotPmts), kwoty płatności pożyczki (Payment), wartości obecnej lub podmiotu zabezpieczeń pożyczki (), przyszłej wartości pożyczki (FValPVal), liczby wskazującej, czy płatność jest należna na początku lub na końcu okresu płatności (PayType), 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 obliczana przez iterację. Począwszy od wartości Guess, Rate przechodzi przez obliczenie do momentu, aż wynik będzie dokładny do 0,00001 procent. Jeśli Rate nie można odnaleźć wyniku po 20 próbach, nie powiedzie się. Jeśli zgadywanie wynosi 10 procent i Rate kończy się niepowodzeniem, spróbuj użyć innej wartości dla Guesselementu .

Dotyczy

Zobacz też