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

定义

返回一个值,该值根据定期、固定付款和固定利率指定年金的未来值。

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

Optional. 一系列未来付款的现值(或总和)。 例如,当你借钱买车时,贷款金额是贷款人每月支付汽车付款的现值。 如果省略,则假定为 0。

Due
DueDate

Optional. 指定付款到期时间的类型 DueDate 的对象。 如果付款在付款期结束时到期,或者DueDate.EndOfPeriod付款在期初到期,则此参数必须是DueDate.BegOfPeriod此参数。 如果省略, DueDate.EndOfPeriod 则假定为

返回

基于定期、固定付款和固定利率的年金的未来价值。

示例

本示例使用FV函数返回投资的未来价值,给定每个周期()、付款总额(APR / 12TotPmts)、付款(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 则还必须使用月份计算。

对于所有参数,现金支付 (如存款到储蓄) 用负数表示:收到的现金 ((如股息检查) )由正数表示。

适用于

另请参阅