Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

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

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

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?