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

Definicja

Zwraca wartość określającą liczbę okresów renty na podstawie okresowych stałych płatności i stałej stopy procentowej.

public static double NPer (double Rate, double Pmt, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod);
static member NPer : double * double * double * double * Microsoft.VisualBasic.DueDate -> double
Public Function NPer (Rate As Double, Pmt As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod) As Double

Parametry

Rate
Double

Wymagane. Stopa procentowa na okres. Jeśli na przykład uzyskasz kredyt na samochód o rocznej stopie procentowej (APR) 10 procent i spłacasz ją w miesięcznych ratach, stopa za okres wynosi 0,1/12, czyli 0,0083.

Pmt
Double

Wymagane. Płatność, która ma być dokonana w każdym okresie. Płatności zwykle zawierają kapitał i odsetki, które nie zmieniają się w ciągu życia renty.

PV
Double

Wymagane. Wartość bieżąca lub wartość bieżąca serii przyszłych płatności lub wpływów. Na przykład przy zaciągnięciu kredytu na zakup samochodu kwota kredytu stanowi dla kredytodawcy wartość bieżącą miesięcznych płatności za samochód, których będziesz dokonywać.

FV
Double

Opcjonalny. Wartość przyszła lub saldo gotówkowe, które chcesz uzyskać po dokonaniu ostatecznej płatności. Na przykład przyszła wartość kredytu wynosi 0 zł, ponieważ taka będzie jego wartość po ostatniej płatności. Jeśli jednak chcesz zaoszczędzić 50 000 zł przez 18 lat na wykształcenie dziecka, 50 000 zł jest wartością przyszłą. W przypadku pominięcia przyjmowana jest wartość 0.

Due
DueDate

Opcjonalny. Obiekt typu DueDate , który określa, kiedy płatności są należne. Ten argument musi być albo DueDate.EndOfPeriod wtedy, gdy 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

Liczba okresów renty na podstawie okresowych stałych płatności i stałej stopy procentowej.

Wyjątki

Rate = 0 i Pmt = 0

Przykłady

W tym przykładzie użyto NPer funkcji , aby zwrócić liczbę okresów, w których należy dokonać płatności w celu spłaty pożyczki, której wartość jest zawarta w PVal. Podano również stopę procentową odsetek na okres (APR / 12), płatność (Payment), przyszłą wartość pożyczki (FVal) oraz liczbę wskazującą, czy płatność jest należna na początku, czy na końcu okresu płatności (PayType).

Sub TestNPer()
    Dim TotPmts As Double
    Dim PVal, APR, Payment As Double
    Dim PayType As DueDate
    Dim Response As MsgBoxResult

    ' Usually 0 for a loan.
    Dim Fval As Double = 0
    PVal = CDbl(InputBox("How much do you want to borrow?"))
    APR = CDbl(InputBox("What is the annual percentage rate of your loan?"))
    ' Usually 0 for a loan.
    If APR > 1 Then APR = APR / 100
    Payment = CDbl(InputBox("How much do you want to pay each month?"))
    Response = MsgBox("Do you make payments at the end of month?", MsgBoxStyle.YesNo)
    If Response = MsgBoxResult.No Then
        PayType = DueDate.BegOfPeriod
    Else
        PayType = DueDate.EndOfPeriod
    End If
    TotPmts = NPer(APR / 12, -Payment, PVal, FVal, PayType)
    If Int(TotPmts) <> TotPmts Then TotPmts = Int(TotPmts) + 1

    MsgBox("It will take you " & TotPmts & " months to pay off your loan.")
End Sub

Uwagi

Renta to szereg stałych płatności gotówkowych dokonywanych w pewnym okresie. Renta może mieć charakter kredytu/pożyczki (np. kredyt hipoteczny) lub inwestycji (np. miesięczny plan oszczędzania).

W przypadku wszystkich argumentów środki wypłacane (na przykład wpłacane na rachunek oszczędnościowy) są wyrażone liczbami ujemnymi, a środki pieniężne otrzymane (na przykład dywidendy) są wyrażone liczbami dodatnimi.

Dotyczy

Zobacz też