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/3603 = actual/3654 = 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 ```

## References

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