Main Content

fvdisc

Future value of discounted security

Description

FutureVal = fvdisc(Settle,Maturity,Price,Discount) finds the amount received at maturity for a fully vested security.

example

FutureVal = fvdisc(___,Basis) specifies options using an optional argument in addition to the input arguments in the previous syntax.

example

Examples

collapse all

This example shows how to use datetime inputs to find the amount received at maturity for a fully-vested security, using the following data.

Settle = datetime(2001,2,15);
Maturity = datetime(2001,5,15);
Price = 100;
Discount = 0.0575;
Basis = 2;

FutureVal = fvdisc(Settle, Maturity, Price, Discount, Basis)
FutureVal = 
101.4420

Input Arguments

collapse all

Settlement date, specified as a scalar datetime, string, or date character vector.

To support existing code, fvdisc also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

Maturity date, specified as a scalar datetime, string, or date character vector.

To support existing code, fvdisc also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

Price (present value) of the security, specified as a scalar numeric.

Data Types: double

Bank discount rate of security, specified as a scalar decimal.

Data Types: double

Day-count basis of the instrument, specified as a scalar integer using one of the following values:

  • 0 = actual/actual

  • 1 = 30/360 (SIA)

  • 2 = actual/360

  • 3 = actual/365

  • 4 = 30/360 (PSA)

  • 5 = 30/360 (ISDA)

  • 6 = 30/360 (European)

  • 7 = actual/365 (Japanese)

  • 8 = actual/actual (ICMA)

  • 9 = actual/360 (ICMA)

  • 10 = actual/365 (ICMA)

  • 11 = 30/360E (ICMA)

  • 12 = actual/365 (ISDA)

  • 13 = BUS/252

For more information, see Basis.

Data Types: double

Output Arguments

collapse all

Amount received at maturity for a fully vested security, returned as a scalar numeric.

Data Types: double

References

[1] Jan Mayle. Standard Securities Calculation Methods. Securities Industry Assn, Volumes I-II, 3rd edition, 1994

Version History

Introduced before R2006a

expand all