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

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Financial.vb

Quelle:: Financial.vb

Quelle:: Financial.vb

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Double

Der Zinssatz einer Annuität pro Zeitraum.

Ausnahmen

ArgumentException

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: