Freigeben über


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

Definition

Gibt einen Wert zurück, der den Zinssatz einer Annuität pro Zeitraum angibt.

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

Parameter

NPer
Double

Erforderlich. Die Gesamtzahl der Zahlungszeiträume für die Annuität. Wenn Sie beispielsweise monatliche Zahlungen für einen Autokredit mit vierjähriger Laufzeit vereinbart haben, beträgt die Summe der Zahlungszeiträume für den Kredit 4 * 12 (oder 48).

Pmt
Double

Erforderlich. Die in jedem Zeitraum zu leistende Zahlung. Die Zahlungen enthalten in der Regel Kapital und Zinsen und ändern sich während der Laufzeit einer Annuität nicht.

PV
Double

Erforderlich. Der Barwert oder heutige Wert einer Folge zukünftiger Einnahmen oder Ausgaben. Wenn Sie beispielsweise einen Kredit für einen Autokauf aufnehmen, stellt die Kredithöhe für den Kreditgeber den Barwert der von Ihnen zu leistenden monatlichen Zahlungen dar.

FV
Double

Dies ist optional. Der Endwert oder Kassenbestand, der nach der letzten Zahlung erreicht sein soll. Der Endwert eines Kredits ist z. B. 0 Euro, da dies die Kredithöhe nach der letzten Zahlung ist. Wenn Sie jedoch für die Ausbildung Ihrer Kinder 50.000 Euro in 18 Jahren ansparen möchten, entspricht der Endwert 50.000 Euro. Wenn der Wert nicht angegeben wird, wird 0 angenommen.

Due
DueDate

Dies ist optional. Ein Objekt vom Typ DueDate, das den Fälligkeitszeitpunkt einer Zahlung angibt. Dieses Argument muss entweder DueDate.EndOfPeriod sein, wenn die Zahlungen am Ende des Zahlungszeitraums fällig sind, oder DueDate.BegOfPeriod, wenn die Zahlungen zu Beginn des Zeitraums fällig sind. Wenn die Werte nicht angegeben werden, wird DueDate.EndOfPeriod angenommen.

Guess
Double

Dies ist optional. Der von Ihnen geschätzte Wert wird von Rate zurückgegeben. Wird der Wert nicht angegeben, so ist Guess gleich 0,1 (10 Prozent).

Gibt zurück

Der Zinssatz einer Annuität pro Zeitraum.

Ausnahmen

NPer<= 0.

Beispiele

In diesem Beispiel wird die Rate -Funktion verwendet, um den Zinssatz eines Darlehens anhand der Gesamtzahl der Zahlungen (TotPmts), des Betrags der Darlehenszahlung (Payment), des Barwerts oder des Kapitals des Darlehens (PVal), des zukünftigen Werts des Darlehens (FVal), einer Zahl zu berechnen, die angibt, ob die Zahlung am Anfang oder Ende des Zahlungszeitraums fällig ist (PayType), und eine Näherung des erwarteten Zinssatzes (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

Hinweise

Eine Annuität ist eine Reihe von festen Barzahlungen, die über einen bestimmten Zeitraum geleistet werden. Eine Annuität kann ein Darlehen (z. B. eine Haushypothek) oder eine Investition (z. B. ein monatlicher Sparplan) sein.

Bei allen Argumenten wird die Auszahlung von Bargeld (z. B. Einlagen in Sparguthaben) durch negative Zahlen dargestellt; Empfangene Mittel (z. B. Dividendenprüfungen) werden durch positive Zahlen dargestellt.

Rate wird nach Iteration berechnet. Beginnend mit dem Wert von Guessdurchläuft Rate die Berechnung, bis das Ergebnis auf 0,00001 Prozent genau ist. Wenn Rate nach 20 Versuchen kein Ergebnis gefunden werden kann, tritt ein Fehler auf. Wenn Ihre Schätzung 10 Prozent beträgt und Rate fehlschlägt, probieren Sie einen anderen Wert für Guessaus.

Gilt für:

Weitere Informationen