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

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Gibt einen Wert zurück, der den Zinssatz pro Periode für eine Annuität 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

Required. Die Gesamtzahl der Zahlungszeiträume in der Annuität. Wenn Sie beispielsweise monatliche Zahlungen für einen Autokredit mit vierjähriger Laufzeit leisten, umfasst Ihr Kredit insgesamt 4 * 12 (also 48) Zahlungszeiträume.

Pmt
Double

Required. Die Zahlung, die für jeden Zeitraum geleistet werden soll. Die Zahlungen enthalten in der Regel Kreditsumme und Zinsen und ändern sich während der Laufzeit einer Annuität nicht.

PV
Double

Required. Der barwert oder der heutige Wert einer Reihe zukünftiger Zahlungen oder Einnahmen. Wenn Sie beispielsweise einen Kredit für ein Auto aufnehmen, ist die Summe dieses Kredits für den Kreditgeber gleich dem Barwert der monatlichen Zahlungen, die Sie für das Auto leisten.

FV
Double

Dies ist optional. Der zukünftige Wert oder barsaldo, den Sie nach der endgültigen Zahlung benötigen. Der zukünftige Wert eines Kredits lautet z. B. "\$0", da dies nach der endgültigen Zahlung der Wert ist. Wenn Sie jedoch \$50.000 über 18 Jahre für die Ausbildung Ihres Kindes speichern möchten, ist \$50.000 der zukünftige Wert. Fehlt dieses Argument, wird 0 angenommen.

Due
DueDate

Dies ist optional. Objekt des Typs DueDate , der angibt, wann Zahlungen fällig sind. Dieses Argument muss entweder DueDate.EndOfPeriod sein, wenn Zahlungen am Ende des Zahlungszeitraums fällig sind oder DueDate.BegOfPeriod zahlungen am Anfang des Zeitraums fällig sind. Wird diese Angabe weggelassen, DueDate.EndOfPeriod wird angenommen.

Guess
Double

Dies ist optional. Der wert, den Sie schätzen, wird von Rate. Wenn nicht angegeben, Guess ist 0,1 (10 Prozent).

Gibt zurück

Double

Der Zinssatz pro Zeitraum für eine Annuität.

Ausnahmen

ArgumentException

NPer <= 0.

Beispiele

In diesem Beispiel wird die Rate Funktion verwendet, um den Zinssatz eines Kredits anhand der Gesamtzahl der Zahlungen (TotPmts), des Betrags der Kreditzahlung (Payment), des Barwerts oder des Kapitals des Kredits (PVal), des zukünftigen Werts des Kredits (FVal), einer Zahl zu berechnen, die angibt, ob die Zahlung am Anfang oder Ende des Zahlungszeitraums fällig ist (PayType), und eine Annäherung an den erwarteten Zinssatz (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 konstanten Barzahlungen, die in einem Zeitraum geleistet werden. Eine Annuität kann ein Kredit (z. B. eine Eigenheimhypothek) oder eine Investition (z. B. eine monatliche Spareinlage) sein.

Für alle Argumente gilt, dass Geldbeträge, die ausgezahlt werden (etwa Spareinlagen), durch negative Zahlen und Geldbeträge, die eingenommen werden (etwa Dividenden), durch positive Zahlen dargestellt werden.

Rate wird durch Iteration berechnet. Beginnend mit dem Wert von Guess, Rate wechselt die Berechnung, bis das Ergebnis auf 0,00001 Prozent genau ist. Wenn Rate ein Ergebnis nach 20 Versuchen nicht gefunden werden kann, schlägt es fehl. Wenn ihre Vermutung 10 Prozent beträgt und Rate fehlschlägt, versuchen Sie einen anderen Wert für Guess.

Gilt für:

Weitere Informationen