Financial.NPer(Double, Double, Double, Double, DueDate) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.