Documentation

This is machine translation

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

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.