Financial.FV メソッド

.NET Framework クラス ライブラリ リファレンス

Financial.FV メソッド

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

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function FV
 ( _
    Rate As Double, _
    NPer As Double, _
    Pmt As Double, _
    <OptionalAttribute> Optional PV As
 Double = 0, _
    <OptionalAttribute> Optional Due As
 DueDate = DueDate.EndOfPeriod _
) As Double

Visual Basic (使用法)

Dim Rate As Double
Dim NPer As Double
Dim Pmt As Double
Dim PV As Double
Dim Due As DueDate
Dim returnValue As Double

returnValue = Financial.FV(Rate, NPer, Pmt, PV, Due)

C#

public static double FV (
    double Rate,
    double NPer,
    double Pmt,
    [OptionalAttribute] double PV,
    [OptionalAttribute] DueDate Due
)

C++

public:
static double FV (
    double Rate, 
    double NPer, 
    double Pmt, 
    [OptionalAttribute] double PV, 
    [OptionalAttribute] DueDate Due
)

J#

public static double FV (
    double Rate, 
    double NPer, 
    double Pmt, 
    /** @attribute OptionalAttribute() */ double PV, 
    /** @attribute OptionalAttribute() */ DueDate Due
)

JScript

public static function FV
 (
    Rate : double, 
    NPer : double, 
    Pmt : double, 
    PV : double, 
    Due : DueDate
) : double

パラメータ

Rate

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

NPer

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

Pmt

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

PV

省略可能。現在の投資額、つまり将来行われる一連の支払いを現時点で一括支払いした場合の合計金額を示す Double 型の値。たとえば、自動車を購入するために資金を借り入れた場合、ローン金額は、毎月の返済の対象となる貸手にとっての現在価値を表します。省略した場合、0 が使用されます。

Due

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

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

解説

詳細については、Visual Basic のトピック「FV 関数」を参照してください。

投資とは、一連の定額の支払いを一定の期間行うことです。たとえば、住宅ローンなどのローンまたは毎月の貯蓄プランなどの出資を指します。

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

すべての引数は、現金の支出 (口座への預け入れなど) を負数で表し、現金の受け取り (配当小切手など) を正数で表します。

使用例

この例では、FV 関数を使用して投資の将来価値を返します。利率 (APR / 12)、支払い回数 (TotPmts)、毎月の支払い額 (Payment)、現在価値 (PVal)、および支払い期日 (PayType) を指定します。Payment は出金を表すので、負数を指定しています。

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Financial クラス
Financial メンバ
Microsoft.VisualBasic 名前空間
その他の技術情報
FV 関数
財務処理の概要