Financial.NPer(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ą 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

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.

Pmt

Double

Required. 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 okresu spłaty renty.

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 środków pieniężnych, które mają zostać dokonane 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

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

Wyjątki

ArgumentException

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ść znajduje się w .PVal Podane są również stopy procentowe dla każdego okresu (APR / 12), spłata (Payment), przyszła wartość pożyczki (FVal) i liczba wskazująca, czy płatność jest należna na początku lub 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

Rata roczna to seria stałych płatności pieniężnych dokonywanych w danym okresie. Może to być pożyczka (na przykład kredyt hipoteczny) lub inwestycja (na przykład miesięczny plan oszczędnościowy).

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