# acrubond

Accrued interest of security with periodic interest payments

## Syntax

``AccruInterest = acrubond(IssueDate,Settle,FirstCouponDate,Face,CouponRate)``
``AccruInterest = acrubond(___,Period,Basis)``

## Description

example

````AccruInterest = acrubond(IssueDate,Settle,FirstCouponDate,Face,CouponRate)` returns the accrued interest for a security with periodic interest payments. `acrubond` computes the accrued interest for securities with standard, short, and long first coupon periods. Note`cfamounts` or `accrfrac` is recommended when calculating accrued interest beyond the first period. ```

example

````AccruInterest = acrubond(___,Period,Basis)` adds optional arguments for `Period` and `Basis`. ```

## Examples

collapse all

This example shows how to find the accrued interest for a bond with semiannual interest payments.

```AccruInterest = acrubond('31-jan-1983', '1-mar-1993', ... '31-jul-1983', 100, 0.1, 2, 0)```
```AccruInterest = 0.8011 ```

This example shows how to use `datetime` inputs to find the accrued interest for a bond with semiannual interest payments.

```AccruInterest = acrubond(datetime('31-jan-1983','Locale','en_US'),datetime('1-mar-1993','Locale','en_US'),datetime('31-jul-1983','Locale','en_US'),... 100, 0.1, 2, 0)```
```AccruInterest = 0.8011 ```

## Input Arguments

collapse all

Issue date of the security, specified as a scalar or a `NINST`-by-`1` vector of serial date numbers, date character vectors, or datetime arrays.

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

Settlement date of the security, specified as a scalar or a `NINST`-by-`1` vector of serial date numbers, date character vectors, or datetime arrays. The `Settle` date must be before the `Maturity` date.

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

First coupon date of the security, specified as a scalar or a `NINST`-by-`1` vector of serial date numbers, date character vectors, or datetime arrays.

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

Redemption value (par value) of the security, specified as a scalar or a `NINST`-by-`1` vector.

Data Types: `double`

Coupon rate of the security, specified as a scalar or a `NINST`-by-`1` vector of decimal fraction values.

Data Types: `double`

(Optional) Number of coupon payments per year for the security, specified as scalar or a `NINST`-by-`1` vector using the values: `0`, `1`, `2`, `3`, `4`, `6`, or `12`.

Data Types: `double`

(Optional) Day-count basis for the security, specified as a scalar or a `NINST`-by-`1` vector. Values are:

• 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

Accrued interest for the security, returned as a scalar or a `NINST`-by-`1` vector.