Financial.PV(Double, Double, Double, Double, DueDate) メソッド

定義

将来の定期的な定額の支払いおよび一定した利率に基づいて、投資の現在価値を指定する値を返します。

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

パラメーター

Rate
Double

必須です。 投資期間を通じての一定の利率です。 たとえば、10% の年率 (APR) で自動車ローンを利用する際、毎月の支払いを指定した場合の月々の利率は 0.1/12 (0.0083) になります。

NPer
Double

必須です。 投資期間全体での支払い回数の合計です。 たとえば、4 年間、月々分割払い自動車ローンを利用した場合、4 × 12 (= 48) の返済期間があることになります。

Pmt
Double

必須です。 毎回の支払い額です。 通常、支払い額には元金と利息が含まれます。支払い額を投資期間内に変更することはできません。

FV
Double

省略可能。 投資の将来価値、つまり最後の支払いを行った後に残る現金の収支です。 たとえば、ローンの将来価値は 0 です。最終支払い後の価値であるためです。 ただし、子供の教育費のため、18 年間かけて 50 万円を貯金する場合、この 50 万円は将来価値になります。 省略した場合は、0 と見なされます。

Due
DueDate

省略可能。 支払い期日を示すオブジェクト型 DueDate の値。 各期の期末に支払う場合は DueDate.EndOfPeriod を、各期の期首に支払う場合は DueDate.BegOfPeriod をそれぞれ引数に指定します。 省略した場合は、DueDate.EndOfPeriod と想定されます。

戻り値

将来の定期的な定額の支払いおよび一定した利率に基づいた、投資の現在価値です。

この例では、 関数は、 PV 次の 20 年間に年間 50,000 ドルを提供する 1,000,000 ドルの年金の現在の値を返します。 提供される数値は、予想される年率 (APR)、支払いの合計数 (TotPmts)、各支払額 (YrIncome)、投資の将来価値の合計 (FVal)、および各支払いが支払期間の開始時または終了時に行われるかどうかを示す数値 (PayType) です。 YrIncomeこれは、毎年年金から支払われる現金を表すので、負の数であることに注意してください。

Sub TestPV()
    ' Define money format.
    Dim Fmt As String = "###,##0.00"
    ' Annual percentage rate.
    Dim APR As Double = 0.0825
    ' Total number of payments.
    Dim TotPmts As Double = 20
    ' Yearly income.
    Dim YrIncome As Double = 50000
    ' Future value.
    Dim FVal As Double = 1000000
    ' Payment at beginning of month.
    Dim PayType As DueDate = DueDate.BegOfPeriod
    Dim PVal As Double = PV(APR, TotPmts, -YrIncome, FVal, PayType)
    MsgBox("The present value is " & Format(PVal, Fmt) & ".")
End Sub

注釈

年金とは、一定期間に行われた一連の固定現金支払いです。 年金は、ローン (住宅ローンなど) または投資 (毎月の節約プランなど) です。

引数と NPer 引数はRate、同じ単位で表される支払期間を使用して計算する必要があります。 たとえば、 が月を使用して計算される場合 Rate は、 NPer も月を使用して計算する必要があります。

すべての引数について、支払われた現金 (預金から預貯金など) は負の数で表されます。受け取った現金 (配当チェックなど) は正の数値で表されます。

適用対象

こちらもご覧ください