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

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Financial.vb

Zwraca wartość określającą spłatę odsetek dla danego okresu renty na podstawie okresowych, stałych płatności i stałej stopy procentowej.

public static double IPmt(double Rate, double Per, double NPer, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod);

static member IPmt : double * double * double * double * double * Microsoft.VisualBasic.DueDate -> double

Public Function IPmt (Rate As Double, Per As Double, NPer As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod) As Double

Parametry

Rate

Double

Required. Stopa procentowa na okres. Na przykład w przypadku kredytu samochodowego o rocznej stopie oprocentowania (RSO) wynoszącej 10%, ze spłatami miesięcznymi, stopa procentowa na okres wynosi 0,1/12, czyli 0,0083.

Per

Double

Required. Okres płatności w zakresie od 1 do NPer.

NPer

Double

Required. Łączna liczba okresów płatności w rentie. Jeśli na przykład dokonasz miesięcznych płatności na czteroletnią pożyczkę samochodową, pożyczka ma łącznie 4 x 12 (lub 48) okresów płatności.

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 uzyskać 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 .

Zwraca

Double

Spłata odsetek dla danego okresu renty na podstawie okresowych, stałych płatności i stałej stopy procentowej.

Wyjątki

ArgumentException

Per <= 0 lub Per>NPer

Przykłady

W tym przykładzie użyto IPmt funkcji , aby obliczyć, ile płatności jest odsetkiem, gdy wszystkie płatności są równe. Podana jest stopa procentowa dla każdego okresu (APR / 12), okres płatności, dla którego część procentowa jest pożądana (Period), całkowita liczba spłat (TotPmts), wartość bieżąca lub kapitał pożyczki (), przyszła wartość pożyczki (PValFVal) oraz liczba wskazująca, czy płatność jest należna na początku lub końcu okresu płatności (PayType).

Sub TestIPMT()
    Dim APR, PVal, Period, IntPmt, TotInt, TotPmts As Double
    Dim PayType As DueDate
    Dim Response As MsgBoxResult

    ' Usually 0 for a loan.
    Dim Fval As Double = 0
    ' Define money format.
    Dim Fmt As String = "###,###,##0.00"
    PVal = CDbl(InputBox("How much do you want to borrow?"))
    APR = CDbl(InputBox("What is the annual percentage rate of your loan?"))
    If APR > 1 Then APR = APR / 100 ' Ensure proper form.
    TotPmts = CInt(InputBox("How many monthly payments?"))
    Response = MsgBox("Do you make payments at end of the month?", MsgBoxStyle.YesNo)
    If Response = MsgBoxResult.No Then
        PayType = DueDate.BegOfPeriod
    Else
        PayType = DueDate.EndOfPeriod
    End If
    For Period = 1 To TotPmts   ' Total all interest.
        IntPmt = IPmt(APR / 12, Period, TotPmts, -PVal, Fval, PayType)
        TotInt = TotInt + IntPmt
    Next Period

    ' Display results.
    MsgBox("You will pay a total of " & Format(TotInt, Fmt) & 
        " in interest for this loan.")
End Sub

Uwagi

Renta jest serią stałych płatności gotówkowych dokonanych w czasie. Może to być pożyczka (na przykład kredyt hipoteczny) lub inwestycja (na przykład miesięczny plan oszczędnościowy).

Argumenty Rate i NPer muszą być obliczane przy użyciu okresów płatności wyrażonych w tych samych jednostkach. Jeśli na przykład Rate jest obliczana przy użyciu miesięcy, NPer należy również obliczyć przy użyciu miesięcy.

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.

Zobacz też

• ArgumentException
• Podsumowanie finansowe