Documentation

fvdisc

Future value of discounted security

Syntax

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

Arguments

Settle

Settlement date. Enter as serial date number, date character vector, or datetime array. Settle must be earlier than Maturity.

Maturity

Maturity date. Enter as serial date number, date character vector, or datetime array.

Price

Price (present value) of the security.

Discount

Bank discount rate of the security. Enter as decimal fraction.

Basis

(Optional) Day-count basis of the instrument. A vector of integers.

  • 0 = actual/actual (default)

  • 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.

Description

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

Examples

collapse all

Find the Amount Received at Maturity for a Fully-Vested Security

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

Settle = '02/15/2001';
Maturity = '05/15/2001';
Price = 100;
Discount = 0.0575;
Basis = 2;

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

  101.4420

Find the Amount Received at Maturity for a Fully-Vested Security Using datetime Inputs

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('02/15/2001','Locale','en_US');
Maturity = datetime('05/15/2001','Locale','en_US');
Price = 100;
Discount = 0.0575;
Basis = 2;

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

  101.4420

Related Examples

References

Mayle, Standard Securities Calculation Methods, Volumes I-II, 3rd edition.

Introduced before R2006a

Was this topic helpful?