Financial.NPV メソッド

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

Financial.NPV メソッド

一連の定期的なキャッシュ フロー (支払いと受け取り) および公定歩合に基づいて、出資の正味現在価値を指定する Double 型の値を返します。

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

Visual Basic (宣言)

Public Shared Function NPV
 ( _
    Rate As Double, _
    ByRef ValueArray As Double()
 _
) As Double

Visual Basic (使用法)

Dim Rate As Double
Dim ValueArray As Double()
Dim returnValue As Double

returnValue = Financial.NPV(Rate, ValueArray)

C#

public static double NPV (
    double Rate,
    ref double[] ValueArray
)

C++

public:
static double NPV (
    double Rate, 
    array<double>^% ValueArray
)

J#

public static double NPV (
    double Rate, 
    /** @ref */ double[] ValueArray
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

Rate

必須。投資期間を通じて一定である公定歩合を小数点を使用して示す Double 型の値。

ValueArray

必須。キャッシュ フローの値を示す Double 型の配列。配列には、負の値 (支払い額) と正の値 (受け取り額) が少なくとも 1 つずつ含まれている必要があります。

戻り値
一連の定期的なキャッシュ フロー (支払いと受け取り) および公定歩合に基づいて、出資の正味現在価値を指定する Double 型の値を返します。

解説

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

投資の正味現在価値とは、将来行われる一連の支払いと受け取りを現時点での現金価値に換算したものです。

NPV 関数では、配列で指定した値の順序がキャッシュ フローの順序であると見なされます。支払い額と受け取り額を入力するときは、その順序に注意してください。

NPV 関数では、投資は配列の最初のキャッシュ フローの日付よりも 1 期前に開始され、配列の最後のキャッシュ フローで終了します。

正味現在価値は、将来のキャッシュ フローを基にして計算されます。最初のキャッシュ フローが第 1 期の期首に発生する場合、その最初の値は ValueArray のキャッシュ フローの値に含めず、NPV の戻り値に加算する必要があります。

NPV 関数は PV 関数 (現在値) によく似ていますが、2 つの関数の違いは、PV 関数ではキャッシュ フローが期首と期末のどちらで発生してもよい点です。NPV 関数ではキャッシュ フローの金額が一定していませんが、PV 関数では投資期間を通じて一定である必要があります。

使用例

この例では、NPV 関数を使用して、配列 values() で指定したキャッシュ フローに対する正味現在価値を返します。FixedRetRate に格納される戻り値は、固定内部利益率を表します。

Visual Basic

' Define money format.
Dim MoneyFmt As String =
 "###,##0.00"
' Define percentage format.
Dim PercentFmt As String
 = "#0.00"

Dim values(4) As Double
' Business start-up costs.
values(0) = -70000
' Positive cash flows reflecting income for four successive years.
values(1) = 22000
values(2) = 25000
values(3) = 28000
values(4) = 31000

' Use the NPV function to calculate the net present value.
' Set fixed internal rate.
Dim FixedRetRate As Double
 = 0.0625
' Calculate net present value.
Dim NetPVal As Double =
 NPV(FixedRetRate, values)
' Display net present value.
MsgBox("The net present value of these cash flows is "
 & _
    Format(NetPVal, MoneyFmt) & ".")

プラットフォーム

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 名前空間
ArgumentException
その他の技術情報
NPV 関数
IRR 関数
MIRR 関数
財務処理の概要