# Documentation

### This is machine translation

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

# yldmat

Yield with interest at maturity

## Syntax

```Yield = yldmat(Settle, Maturity, Issue, Face, Price,CouponRate, Basis)
```

## Arguments

 `Settle` Settlement date, specified as erial date numbers, date character vectors, or datetime arrays. `Settle` must be earlier than `Maturity`. `Maturity` Maturity date, specified as serial date numbers, date character vectors, or datetime arrays. `Issue` Issue date, specified as serial date numbers, date character vectors, or datetime arrays. `Face` Redemption (par, face) value. `Price` Price of the security. `CouponRate` Coupon rate. 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 (BMA)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/252For more information, see basis.

## Description

```Yield = yldmat(Settle, Maturity, Issue, Face, Price, CouponRate, Basis)``` returns the yield of a security paying interest at maturity.

## Examples

collapse all

This example shows how to find the yield of a security paying interest at maturity for the following.

```Settle = '02/07/2000'; Maturity = '04/13/2000'; Issue = '10/11/1999'; Face = 100; Price = 99.98; CouponRate = 0.0608; Basis = 1; Yield = yldmat(Settle, Maturity, Issue, Face, Price,... CouponRate, Basis) ```
```Yield = 0.0607 ```

This example shows how to use `datetime` inputs find the yield of a security paying interest at maturity for the following:

```Settle = '7-Feb-2000'; Maturity = '13-Apr-2000'; Issue = '11-Oct-1999'; Face = 100; Price = 99.98; CouponRate = 0.0608; Basis = 1; Settle = datetime(Settle,'Locale','en_US'); Maturity = datetime(Maturity,'Locale','en_US'); Issue = datetime(Issue,'Locale','en_US'); Yield = yldmat(Settle, Maturity, Issue, Face, Price,... CouponRate, Basis) ```
```Yield = 0.0607 ```

## References

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