Financial.FV(Double, Double, Double, Double, DueDate) 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

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

必要。 每期利率。 例如，如果您的汽車貸款年利率 (APR) 為 10% 並採月付方式償還，則每期的利率為 0.1/12，也就是 0.0083。

NPer

Double

必要。 年金中付款的總期數。 例如，如果您的四年期汽車貸款是採月付方式償還，則付款總期數就是 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 也必須使用月份來計算。

對於所有自變數，支付的現金 (例如儲存) 的現金會以負數表示;收到現金 (，例如正數表示) 的除數檢查。

另請參閱

• 財務摘要