Financial.FV(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 FV(double Rate, double NPer, double Pmt, double PV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod);
static member FV : double * double * double * double * Microsoft.VisualBasic.DueDate -> double
Public Function FV (Rate As Double, NPer As Double, Pmt As Double, Optional PV 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

必須。 各期間に行われる支払い。 支払額には通常、投資期間内に変化しない元金額と利息が含まれます。

PV
Double

このフィールドは省略可能です。 一連の将来の支払いの現在価値 (または一括合計)。 たとえば、車の購入資金を借りた場合、ローン金額は、借り手が毎月行う返済の貸し手に対する現在価値です。 省略した場合、0 が想定されます。

Due
DueDate

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

返品

Double

定期支払い、固定利率に基づく年金の将来価値。

例

次の使用例は、 FV 関数を使用して、投資の将来価値を返します。これには、期間 (APR / 12)、支払いの合計数 (TotPmts)、支払い (Payment)、投資の現在価値 (PVal)、および支払い期間の開始時または終了時 (PayType) を示す数値が表示されます。 Paymentは支払われた現金を表すので、負の数であることに注意してください。

Sub TestFV()
    Dim TotPmts As Integer
    Dim Payment, APR, PVal, Fval As Double
    Dim PayType As DueDate
    Dim Response As MsgBoxResult

    ' Define money format.
    Dim Fmt As String = "###,###,##0.00"
    Payment = CDbl(InputBox("How much do you plan to save each month?"))
    APR = CDbl(InputBox("Enter the expected interest annual percentage rate."))
    ' Ensure proper form.
    If APR > 1 Then APR = APR / 100
    TotPmts = CInt(InputBox("For how many months do you expect to save?"))
    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
    PVal = CDbl(InputBox("How much is in this savings account now?"))
    Fval = FV(APR / 12, TotPmts, -Payment, -PVal, PayType)
    MsgBox("Your savings will be worth " & Format(Fval, Fmt) & ".")
End Sub

注釈

年金は、時間の経過と同時に行われる一連の固定現金支払いです。 投資としては、ローン (住宅ローンなど) または本来の投資 (毎月の貯蓄プランなど) が該当します。

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

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

適用対象

こちらもご覧ください