disMaturityValBond {bondAnalyst}R Documentation

Calculates the Discounted Value of the the Par Value of the Bond or the amount to be paid at the maturity of the Bond using the Market Discount Rate.

Description

Calculates the Discounted Value of the the Par Value of the Bond or the amount to be paid at the maturity of the Bond using the Market Discount Rate.

Usage

disMaturityValBond(bondMaturityVal, n, r)

Arguments

bondMaturityVal

A number.

n

A number.

r

A number.

Details

The par value of a bond is the amount that the issuer agrees to repay the holder of the debt instrument by the maturity date. This amount is also referred to as the principal amount, face value, or maturity value. Bonds can have any par value. Because debt instruments can have a different par value, the practice is to quote the price of a debt instrument as a percentage of its par value. A value of 100 means 100% of par value. So, for example, if a debt instrument has a par value of $1,000 and is selling for $900, it would be said to be selling at 90. If a debt instrument with a par value of 5,000 is selling for $5,500, it is said to be selling for 110 (Fabozzi, 2008). Based on this, the method disMaturityValBond() is developed to compute the present value or discounted value of the Par Value of the Bond. So, disMaturityValBond() gives the discounted value of Par Value, Face Value, Maturity Value, or Principal amount for values passed to its three arguments. Here bondMaturityVal is amount of Par Value or Maturity Value of the Bond, n represents number of years till maturity and r is Market Discount Rate or Required Rate of return. The output is rounded off to three decimal places.

Value

Input values to three arguments bondMaturityVal , n and r.

Author(s)

MaheshP Kumar, maheshparamjitkumar@gmail.com

References

Fabozzi,F.J. (2008). Handbook of Finance: Financial Markets and Instruments. John Wiley & Sons, Incorporated. ISBN 9780470078143.

Examples

disMaturityValBond (bondMaturityVal=100,n=5,r=0.06)
disMaturityValBond (100,5,0.06)

[Package bondAnalyst version 1.0.1 Index]