bondyield2(cpn;mat;dcb;issu;first;freq;setl;price)
Returns the bond yield given price (general).
Syntax
bondyield2(cpn;mat;dcb;issu;first;freq;setl;price)
Input
Argument | Type | Description |
---|---|---|
cpn |
integer or decimal | The annual coupon rate expressed as a percentage A scalar value or the name of a column |
mat |
integer | The maturity date A scalar value or the name of a column |
dcb |
text | The day count basis (dcb) A text value or the name of a column Generally, |
issu |
integer | The original dated date A scalar value or the name of a column |
first |
integer | The first coupon date A scalar value or the name of a column The first
coupon date and the maturity date must be a whole number of |
freq |
integer | The number of coupon payments per year (e.g., 2 for semiannual) A scalar value or the name of a column |
setl |
integer | The settlement date The |
price |
integer or decimal | The price (without accrued interest) expressed as a percentage A scalar value or the name of a column |
setl
, which cannot be a column name.Return Value
Returns the bond-equivalent yield expressed as a percentage as a decimal value.
bondyield2(cpn;mat;dcb;issu;first;freq;setl;price)
function handles
N/A values as follows:- If
cpn
,mat
, orprice
are N/A, the result is N/A. - If
dcb
is N/A, actual/actual is used. - If
freq
is N/A, it is assumed to be 2 (semiannual). - If
issu
is N/A, it is assumed to be 30 years prior to maturity. - If
first
is N/A, it is assumed to be the first date after issue that is an integral number of payment periods from maturity.