Difference between revisions of "Manuals/calci/YIELDMAT"
| (5 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | =YIELDMAT( | + | <div style="font-size:30px">'''YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis)'''</div><br/> |
| − | *where <math> | + | *where <math>Settlement</math> is security's settlement date (a date when coupon or a bond is purchased), |
| − | *<math> | + | *<math>Maturity</math> is security's maturity date (a date when coupon or a bond expires), |
| − | *<math> | + | *<math>Issue</math> is security's issue date (a date when coupon or a bond is issued), |
| − | *<math> | + | *<math>Rate</math> is security's annual coupon rate, |
| − | *<math> | + | *<math>Price</math> is the price per $100 face value, |
| − | *<math> | + | *<math>Basis</math> is the type of day count basis to use. |
| − | + | **YIELDMAT(), returns the annual yield of a security that pays interest at maturity. | |
| − | YIELDMAT() | ||
== Description == | == Description == | ||
| − | YIELDMAT( | + | YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis) |
*YIELDMAT is the percentage annual yield on security that pays interest at maturity. | *YIELDMAT is the percentage annual yield on security that pays interest at maturity. | ||
| − | *<math> | + | *<math>Settlement</math>, <math>Maturity</math> and <math>Issue</math> dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message. |
| − | *Dates should satisfy the following condition:- <math> | + | *Dates should satisfy the following condition:- <math>Maturity</math> > <math>Settlement</math> > <math>Issue</math>, else Calci displays #N/A error message. |
| − | *<math> | + | *<math>Rate</math> value must be greater than or equal to zero, else Calci displays #N/A error message. |
| − | *<math> | + | *<math>Price</math> value must be greater than zero, else Calci displays #N/A error message. |
| − | *<math> | + | *<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0. |
| − | Below table shows the use of <math> | + | Below table shows the use of <math>Basis</math> values: |
{| class="wikitable" | {| class="wikitable" | ||
| Line 37: | Line 36: | ||
|} | |} | ||
| − | *If <math> | + | *If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message. |
== Examples == | == Examples == | ||
| − | + | YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis) function with inputs in order is calculated as follows: | |
| − | YIELDMAT( | ||
<div id="2SpaceContent" class="zcontent" align="left"> | <div id="2SpaceContent" class="zcontent" align="left"> | ||
| Line 74: | Line 72: | ||
=YIELDMAT(DATE(2007,1,1), DATE(2008,2,20), DATE(2006,10,15), "5%", 100) : Calculates the percentage annual yield with the inputs. <br />Returns '''4.95%''' as a result. | =YIELDMAT(DATE(2007,1,1), DATE(2008,2,20), DATE(2006,10,15), "5%", 100) : Calculates the percentage annual yield with the inputs. <br />Returns '''4.95%''' as a result. | ||
| + | |||
| + | ==Related Videos== | ||
| + | |||
| + | {{#ev:youtube|v=bch4k9RznVk|280|center|YIELDMAT}} | ||
== See Also == | == See Also == | ||
| Line 85: | Line 87: | ||
*[http://en.wikipedia.org/wiki/Yield_to_maturity Yield to Maturity] | *[http://en.wikipedia.org/wiki/Yield_to_maturity Yield to Maturity] | ||
*[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention] | *[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention] | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | *[[Z_API_Functions | List of Main Z Functions]] | ||
| + | |||
| + | *[[ Z3 | Z3 home ]] | ||
Latest revision as of 16:10, 16 November 2018
YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis)
- where is security's settlement date (a date when coupon or a bond is purchased),
- is security's maturity date (a date when coupon or a bond expires),
- is security's issue date (a date when coupon or a bond is issued),
- is security's annual coupon rate,
- is the price per $100 face value,
- is the type of day count basis to use.
- YIELDMAT(), returns the annual yield of a security that pays interest at maturity.
is security's settlement date (a date when coupon or a bond is purchased),
is security's maturity date (a date when coupon or a bond expires),
is security's issue date (a date when coupon or a bond is issued),
is security's annual coupon rate,
is the price per $100 face value,
is the type of day count basis to use.
Description
YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis)
- YIELDMAT is the percentage annual yield on security that pays interest at maturity.
- , and dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
- Dates should satisfy the following condition:- > > , else Calci displays #N/A error message.
- value must be greater than or equal to zero, else Calci displays #N/A error message.
- value must be greater than zero, else Calci displays #N/A error message.
- value is optional. If omitted, Calci assumes it to be 0.
Below table shows the use of values:
| Basis | Description |
|---|---|
| 0 | US (NASD) 30/360 |
| 1 | Actual/actual |
| 2 | Actual/360 |
| 3 | Actual/365 |
| 4 | European 30/360 |
- If value is other than 0 to 4, Calci displays #N/A error message.
Examples
YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis) function with inputs in order is calculated as follows:
| 1/2/2010 | |
| 1/2/2012 | |
| 12/1/2009 | |
| 5.5% | |
| $100 | |
| 0 |
=YIELDMAT(A1,A2,A3,A4,A5,A6) : Calculates the percentage annual yield with the inputs in the range A1 to A6. Returns 5.47% as a result.
=YIELDMAT(DATE(2007,1,1), DATE(2008,2,20), DATE(2006,10,15), "5%", 100) : Calculates the percentage annual yield with the inputs.
Returns 4.95% as a result.
Related Videos
See Also
References