Difference between revisions of "Manuals/calci/YIELDMAT"

 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=YIELDMAT(settlement, maturity, issue, rate, price, basis)=
+
<div style="font-size:30px">'''YIELDMAT (Settlement,Maturity,Issue,Rate,Price,Basis)'''</div><br/>
  
*where <math>settlement</math> is security's settlement date (a date when coupon or a bond is purchased),  
+
*where <math>Settlement</math> is security's settlement date (a date when coupon or a bond is purchased),  
*<math>maturity</math> is security's maturity date (a date when coupon or a bond expires),  
+
*<math>Maturity</math> is security's maturity date (a date when coupon or a bond expires),  
*<math>issue</math> is security's issue date (a date when coupon or a bond is issued),
+
*<math>Issue</math> is security's issue date (a date when coupon or a bond is issued),
*<math>rate</math> is security's annual coupon rate,  
+
*<math>Rate</math> is security's annual coupon rate,  
*<math>price</math> is the price per $100 face value,
+
*<math>Price</math> is the price per $100 face value,
*<math>basis</math> is the type of day count basis to use.
+
*<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() calculates the annual yield on a security or a bond that pays interest at maturity.
 
  
 
== Description ==
 
== Description ==
  
YIELDMAT(settlement, maturity, issue, rate, price, basis)
+
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>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.
+
*<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>maturity</math> &gt; <math>settlement</math> &gt; <math>issue</math>, else Calci displays #N/A error message.
+
*Dates should satisfy the following condition:- <math>Maturity</math> &gt; <math>Settlement</math> &gt; <math>Issue</math>, else Calci displays #N/A error message.
*<math>rate</math> value must be greater than or equal to zero, else Calci displays #N/A error message.
+
*<math>Rate</math> value must be greater than or equal to zero, else Calci displays #N/A error message.
*<math>price</math> value must be greater than zero, else Calci displays #N/A error message.
+
*<math>Price</math> value must be greater than zero, else Calci displays #N/A error message.
*<math>basis</math> value is optional. If omitted, Calci assumes it to be 0.  
+
*<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0.  
Below table shows the use of <math>basis</math> values:
+
Below table shows the use of <math>Basis</math> values:
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 37: Line 36:
 
|}
 
|}
  
*If <math>basis</math> value is other than 0 to 4, Calci displays #N/A error message.
+
*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(settlement, maturity, issue, rate, price, basis) function with inputs in order is calculated as follows:
 
  
 
<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.

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

YIELDMAT

See Also

References