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

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

Zwraca wartość określającą stopę procentową na okres dla 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

Required. Łączna liczba okresów płatności w rentie. Na przykład w przypadku czteroletniego kredytu samochodowego ze spłatami miesięcznymi całkowita liczba okresów spłat wynosi 4 * 12 (czyli 48).

Pmt
Double

Required. Płatność, która ma być dokonana w każdym okresie. Rata obejmuje zazwyczaj kapitał oraz odsetki i te wartości nie zmieniają się w okresie obowiązywania raty rocznej.

PV
Double

Required. Wartość bieżąca lub wartość bieżąca serii przyszłych płatności lub wpływów. Na przykład, gdy pożyczysz pieniądze na zakup samochodu, kwota pożyczki jest obecną wartością dla pożyczkodawcy miesięcznych płatności samochodowych, które dokonasz.

FV
Double

Optional. Wartość przyszła lub saldo gotówkowe, które chcesz wykonać po dokonaniu ostatecznej płatności. Na przykład przyszła wartość pożyczki to \$0, ponieważ jest to jego wartość po ostatecznej płatności. Jeśli jednak chcesz zaoszczędzić \$50,000 w ciągu 18 lat na edukację dziecka, to \$50,000 jest wartością przyszłą. W razie pominięcia tego argumentu przyjmowana jest wartość 0.

Due
DueDate

Optional. 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 przyjmuje się założenie DueDate.EndOfPeriod .

Guess
Double

Optional. Szacowana wartość jest zwracana przez Rateelement . W przypadku pominięcia Guess wartość to 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 (PValFVal), liczbę wskazującą, czy płatność jest należna na początku lub na koniec 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

Rata roczna to seria stałych płatności pieniężnych dokonywanych w danym okresie. Może to być pożyczka (na przykład kredyt hipoteczny) lub inwestycja (na przykład miesięczny plan oszczędnościowy).

Przy wszystkich argumentach środki wpłacane przez Ciebie, takie jak wpłaty na rachunki oszczędnościowe, wyrażone są liczbami ujemnymi, podczas gdy przychody, takie jak wypłaty z tytułu dywidend, wyrażone są liczbami dodatnimi.

Rate jest obliczany przez iterację. Począwszy od wartości Guess, Rate cykle 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, 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ż