Difference between revisions of "Manuals/calci/YIELDDISC"

From ZCubes Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=YIELDDISC(settlement, maturity, price, redemption, basis)=
+
<div style="font-size:30px">'''YIELDDISC (Settlement,Maturity,Price,Redemption,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>price</math> is the price per $100 face value,
+
*<math>Price</math> is the price per $100 face value,
*<math>redemption</math> is security's redemption value per &#36;100 face value,
+
*<math>Redemption</math> is security's redemption value per &#36;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.
 
+
**YIELDDISC(), returns the annual yield for a discounted security; for example, a Treasury bill.
YIELDDISC() calculates the annual yield on discounted security or a bond.
 
  
 
== Description ==
 
== Description ==
  
YIELDDISC(settlement, maturity, price, redemption, basis)
+
YIELDDISC (Settlement,Maturity,Price,Redemption,Basis)
  
 
*YIELDDISC referred to as 'Discount Yield' is the measure of security's percentage return.
 
*YIELDDISC referred to as 'Discount Yield' is the measure of security's percentage return.
Line 19: Line 18:
 
  <math>Discount Yield = \frac{(par value - price)}{par value} * \frac{360}{days to maturity}</math>
 
  <math>Discount Yield = \frac{(par value - price)}{par value} * \frac{360}{days to maturity}</math>
  
*<math>settlement</math> and <math>maturity</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> and <math>Maturity</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.
*If <math>settlement</math> date = <math>maturity</math> date, Calci displays #N/A error message.
+
*If <math>Settlement</math> date = <math>Maturity</math> date, Calci displays #N/A error message.
*<math>price</math> and <math>redemption</math> values must be greater than zero, else Calci displays #N/A error message.
+
*<math>Price</math> and <math>Redemption</math> values 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 40: Line 39:
 
|}
 
|}
  
*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 ==
  
YIELDDISC(settlement, maturity, price, redemption, basis) function with inputs in order is calculated as follows:
+
YIELDDISC (Settlement,Maturity,Price,Redemption,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 62: Line 61:
  
 
|- class="odd"
 
|- class="odd"
| class="sshl_f" | $100
+
| class="sshl_f" | 100
 
| class="sshl_f" |  
 
| class="sshl_f" |  
  
Line 73: Line 72:
 
  =YIELDDISC(A1,A2,A3,A4,A5) : Calculates the discount yield Value with the inputs in the range A1 to A5. Returns '''33.3%''' as a result.
 
  =YIELDDISC(A1,A2,A3,A4,A5) : Calculates the discount yield Value with the inputs in the range A1 to A5. Returns '''33.3%''' as a result.
 
  =YIELDDISC(DATE(2007,1,1), DATE(2008,2,20), 85.12, 100) : Calculates the discount yield Value with the inputs. Returns '''15.39%''' as a result.
 
  =YIELDDISC(DATE(2007,1,1), DATE(2008,2,20), 85.12, 100) : Calculates the discount yield Value with the inputs. Returns '''15.39%''' as a result.
 +
 +
==Related Videos==
 +
 +
{{#ev:youtube|v=RhNtIcbpfXA|280|center|YIELDDISC}}
  
 
== See Also ==
 
== See Also ==
Line 84: Line 87:
 
*[http://en.wikipedia.org/wiki/Discounting Discount Yield]
 
*[http://en.wikipedia.org/wiki/Discounting Discount Yield]
 
*[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:06, 16 November 2018

YIELDDISC (Settlement,Maturity,Price,Redemption,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 the price per $100 face value,
  • is security's redemption value per $100 face value,
  • is the type of day count basis to use.
    • YIELDDISC(), returns the annual yield for a discounted security; for example, a Treasury bill.

Description

YIELDDISC (Settlement,Maturity,Price,Redemption,Basis)

  • YIELDDISC referred to as 'Discount Yield' is the measure of security's percentage return.

Formula:-


  • 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.
  • If date = date, Calci displays #N/A error message.
  • and values 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

YIELDDISC (Settlement,Maturity,Price,Redemption,Basis) function with inputs in order is calculated as follows:

1/1/2008
20/2/2008
95.58
100
2
=YIELDDISC(A1,A2,A3,A4,A5) : Calculates the discount yield Value with the inputs in the range A1 to A5. Returns 33.3% as a result.
=YIELDDISC(DATE(2007,1,1), DATE(2008,2,20), 85.12, 100) : Calculates the discount yield Value with the inputs. Returns 15.39% as a result.

Related Videos

YIELDDISC

See Also

References