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

Reference

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Zdroj:: Financial.vb

Zdroj:: Financial.vb

Zdroj:: Financial.vb

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí hodnotu určující úrokovou sazbu za období pro anuitu.

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

Povinná hodnota. Celkový počet platebních období v anuitě. Pokud například měsíčně splácíte čtyřletou půjčku na auto, má vaše půjčka celkem 4 × 12 (nebo 48) platebních období.

Pmt: Double

Povinná hodnota. Platba, která se má provést v každém období. Platby obvykle obsahují jistinu a úrok, který se v průběhu anuity nemění.

PV: Double

Povinná hodnota. Aktuální hodnota nebo dnešní hodnota řady budoucích plateb nebo příjmů. Například půjčíte-li si peníze na nákup automobilu, je výše úvěru aktuální hodnotou věřitele při započtení splacených měsíčních splátek.

FV: Double

Nepovinný parametr. Budoucí hodnota nebo peněžní zůstatek, který chcete po provedení konečné platby. Například budoucí hodnota půjčky je 0 Kč, protože toto je její hodnota po poslední splátce. Avšak pokud chcete naspořit za 18 let na vzdělání dítěte částku 500 000 Kč, je budoucí hodnotou částka 500 000 Kč. Je-li hodnota vynechána, předpokládá se hodnota 0.

Due: DueDate

Nepovinný parametr. Objekt typu DueDate , který určuje, kdy jsou platby splatné. Tento argument musí být buď DueDate.EndOfPeriod v případě, že jsou platby splatné na konci platebního období, nebo DueDate.BegOfPeriod pokud jsou platby splatné na začátku období. Pokud je vynechán, DueDate.EndOfPeriod předpokládá se.

Guess: Double

Nepovinný parametr. Hodnota, kterou odhadnete, vrátí parametr Rate. Pokud je vynechán, Guess je 0,1 (10 procent).

Návraty

Double

Úroková sazba za období anuity.

Výjimky

ArgumentException

NPer<= 0.

Příklady

Tento příklad používá Rate funkci k výpočtu úrokové sazby půjčky vzhledem k celkovému počtu splátek (TotPmts), výši splátky půjčky (Payment), současné hodnotě nebo jistině půjčky (PVal), budoucí hodnotě půjčky (FVal), číslu, které určuje, zda je splátka splatná na začátku nebo na konci platebního období (PayType), a přibližnou aproximaci očekávané úrokové sazby (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

Poznámky

Anuita je série pevných hotovostních plateb v průběhu určitého časového období. Anuita může být půjčka (například hypotéka na dům) nebo investice (například spoření s měsíčními splátkami).

U všech argumentů je odchozí hotovostní platba (například vklad na spoření) reprezentována záporným číslem. Příchozí hotovostní platba (například výplata dividendy) je reprezentována kladným číslem.

Rate se počítá iterací. Počínaje hodnotou Guessse Rate přepočítáváním prochází, dokud výsledek nepřesně dosáhne hodnoty 0,00001 %. Pokud Rate se po 20 pokusech nepodaří najít výsledek, selže. Pokud je váš odhad 10 procent a Rate selže, zkuste použít jinou hodnotu pro Guess.

Platí pro