Difference between revisions of "Manuals/calci/YIELDMAT"
| (7 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 72: | Line 70: | ||
=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(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. <br />Returns '''4.95%''' as a result. | ||
| + | |||
| + | ==Related Videos== | ||
| + | |||
| + | {{#ev:youtube|v=bch4k9RznVk|280|center|YIELDMAT}} | ||
== See Also == | == See Also == | ||
| Line 83: | 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 15:10, 16 November 2018
YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis)
- where Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Settlement} is security's settlement date (a date when coupon or a bond is purchased),
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Maturity} is security's maturity date (a date when coupon or a bond expires),
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Issue} is security's issue date (a date when coupon or a bond is issued),
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Rate} is security's annual coupon rate,
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Price} is the price per $100 face value,
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis}
is the type of day count basis to use.
- YIELDMAT(), returns the annual yield of a security that pays interest at maturity.
Description
YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis)
- YIELDMAT is the percentage annual yield on security that pays interest at maturity.
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Settlement} , Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Maturity} and Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Issue} 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:- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Maturity} > Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Settlement} > Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Issue} , else Calci displays #N/A error message.
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Rate} value must be greater than or equal to zero, else Calci displays #N/A error message.
- Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Price} 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 Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} values:
| Basis | Description |
|---|---|
| 0 | US (NASD) 30/360 |
| 1 | Actual/actual |
| 2 | Actual/360 |
| 3 | Actual/365 |
| 4 | European 30/360 |
- If Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} 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