# Documentation

### This is machine translation

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

# prmat

Price with interest at maturity

## Syntax

``[Price,AccruInterest] = prmat(Settle,Maturity,Issue,Face,CouponRateYield)``
``[Price,AccruInterest] = prmat(___,Basis)``

## Description

example

````[Price,AccruInterest] = prmat(Settle,Maturity,Issue,Face,CouponRateYield)` returns the price and accrued interest of a security that pays interest at maturity. This function also applies to zero coupon bonds or pure discount securities by setting `CouponRate` = `0`.```

example

````[Price,AccruInterest] = prmat(___,Basis)` adds an optional argument for `Basis`. ```

## 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 ```

## Input Arguments

collapse all

Settlement date of the security, specified as serial date numbers, date character vectors, or datetime arrays. The `Settle` date must be before the `Maturity` date.

Data Types: `double` | `char` | `datetime`

Maturity date of the security, specified as serial date numbers, date character vectors, or datetime arrays.

Data Types: `double` | `char` | `datetime`

Issue date of the security, specified as serial date numbers, date character vectors, or datetime arrays.

Data Types: `double` | `char` | `datetime`

Redemption value (par value), specified as a numeric value.

Data Types: `double`

Coupon rate, specified as a decimal fraction value.

Data Types: `double`

Annual yield, specified as a decimal fraction value.

Data Types: `double`

(Optional) Day-count basis of the security, specified using 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

Data Types: `double`

## Output Arguments

collapse all

Security price, returned as a numeric value.

Accured interest for security, returned as a numeric value.

## References

[1] Mayle, J. Standard Securities Calculation Methods. Volumes I-II, 3rd edition. Formula 3.