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

定義

名前空間:
Microsoft.VisualBasic
アセンブリ:
Microsoft.VisualBasic.Core.dll
アセンブリ:
Microsoft.VisualBasic.dll
ソース:
Financial.vb
ソース:
Financial.vb
ソース:
Financial.vb
ソース:
Financial.vb
ソース:
Financial.vb

将来支払われる定期的な固定支払いと固定利率に基づいて、年金の現在価値を指定する値を返します。

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) で自動車ローンを契約し、月払いで返済を行う場合、1 か月の利率は 0.1/12 (0.0083) になります。

NPer
Double

必須。 年金の支払期間の合計数。 たとえば、4 年間の自動車ローンで月払いを行う場合、ローンの支払い期間は 4 x 12 (または 48) になります。

Pmt
Double

必須。 各期間に行われる支払い。 通常、支払いには、年金の有効期間中に変更されない元金と利息が含まれます。

FV
Double

このフィールドは省略可能です。 最終的な支払いを行った後に必要な将来価値または現金残高。 たとえば、ローンの将来価値は \$0 です。これは、最終的な支払い後の値であるためです。 ただし、お子様の教育のために 18 年間で \$50,000 を節約する場合は、\$50,000 が将来の価値になります。 省略した場合、0 が想定されます。

Due
DueDate

このフィールドは省略可能です。 支払い期限を指定する DueDate 型のオブジェクト。 この引数は、支払い期間の終了時に支払いが行われる場合は DueDate.EndOfPeriod 、支払い期限が期間の初めに支払われる場合は DueDate.BegOfPeriod する必要があります。 省略すると、 DueDate.EndOfPeriod が想定されます。

返品

Double

将来支払われる定期的な固定支払いと固定利率に基づく年金の現在価値。

例

この例では、 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

注釈

これらの関数の対象となる投資は、定額の支払いが定期的に行われることが前提になっています。 投資としては、ローン (住宅ローンなど) または本来の投資 (毎月の貯蓄プランなど) が該当します。

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

すべての引数に関して、定額預金の支払いのような出金は負の数で表し、配当金のような入金は正の数で表します。

適用対象

こちらもご覧ください