Documentation

This is machine translation

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

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this 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

For more information, see basis.

Data Types: double

Output Arguments

collapse all

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

Introduced before R2006a

Was this topic helpful?