Difference between revisions of "Manuals/calci/YIELD"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left"> '''YIELD'''(SettlementDate, MaturityDate, Rate, Price, Redemption, Frequency, Basis) where, '''SettlementDate''...")
 
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
<div id="6SpaceContent" class="zcontent" align="left">
+
<div style="font-size:30px">'''YIELD (Settlement,MaturityDate,Rate,Price,RedemptionValue,Frequency,Basis)'''</div><br/>
  
−
'''YIELD'''(SettlementDate, MaturityDate, Rate, Price, Redemption, Frequency, Basis)
+
*where <math>Settlement</math> is security's settlement date (a date when coupon or a bond is purchased),  
 +
*<math>MaturityDate</math> is security's maturity date (a date when coupon or a bond expires),  
 +
*<math>Rate</math> is security's annual coupon rate,  
 +
*<math>Price</math> is the price per $100 face value,
 +
*<math>RedemptionValue</math> is security's redemption value per &#36;100 face value,
 +
*<math>Frequency</math> is the number of coupon payments per year, and
 +
*<math>Basis</math> is the type of day count basis to use.
 +
**YIELD(), returns the yield on a security that pays periodic interest.
  
−
where,
+
== Description ==
  
−
'''SettlementDate''' - represents the settlement date.
+
YIELD (Settlement,MaturityDate,Rate,Price,RedemptionValue,Frequency,Basis)
  
−
'''MaturityDate''' - represents the maturity date.
+
*Yield is the annual percentage return on an investment or security. Yield is the value obtained by dividing Annual Interest by Bond Price.  
  
−
'''Rate''' - represents the  rate.
+
'''Formula''':-
 +
If B= Number of days from beginning of coupon period to settlement date,
 +
    C= Number of days in coupon period,
 +
    N= Number of days from settlement date to redemption date
  
−
'''Price''' - represents the price per $100 face value.
+
:<math>YIELD = \dfrac{(\dfrac{redemption}{100}+\dfrac{rate}{frequency})-(\dfrac{par}{100}+(\dfrac{B}{C}*\dfrac{rate}{frequency}))}{\dfrac{par}{100}+(\dfrac{B}{C}*\dfrac{rate}{frequency})}*\dfrac{frequency*C}{N}</math>
  
−
'''Redemption''' - is the redemption value per $100 face value.
+
*<math>Settlement</math> and <math>MaturityDate</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>MaturityDate</math> date, 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> and <math>Redemption</math> values must be greater than zero, else Calci displays #N/A error message.
 +
*The values for <math>Frequency</math> should be 1,2 or 4.  
 +
For Annual payment, <math>Frequency</math> = 1,
  
−
'''Frequency''' - the number of coupon payment per year.
+
For Semi-annual payment, <math>Frequency</math> = 2,
  
−
'''Payments              frequency'''
+
For Quarterly payment, <math>Frequency</math> = 4.
  
−
annual                     1
+
*<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0.
 +
Below table shows the use of <math>basis</math> values:
  
−
semiannual               2
+
{| class="wikitable"
 +
|-
 +
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
  
−
quarterly                  4
+
*If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
−
'''Basis''' - type of day count basis
+
== Examples ==
  
−
'''Basis              Day count basis'''
+
YIELD (Settlement,MaturityDate,Rate,Price,RedemptionValue,Frequency,Basis) function with inputs in order is calculated as follows:
  
−
0 or omitted    US 30/360
+
<div id="2SpaceContent" class="zcontent" align="left">
  
−
1                     Actual/actual
+
{| id="TABLE3" class="SpreadSheet blue"
 +
|- class="even"
 +
| class="sshl_f" | 2/2/2008
 +
| class="sshl_f" |
  
−
2                     Actual/360
+
|- class="odd"
 +
| class="sshl_f" | 11/2/2010
 +
| class="sshl_f" |
  
−
3                     Actual/365
+
|- class="even"
 +
| class="sshl_f" | 5%
 +
| class="sshl_f" |
  
−
4                     European 30/360
+
|- class="odd"
 +
| class="sshl_f" | 97
 +
| class="sshl_f" |
  
−
</div>
+
|- class="even"
−
----
+
| class="sshl_f" | $100
−
<div id="1SpaceContent" class="zcontent" align="left">
+
| class="sshl_f" |
  
−
It returns the yield that pays periodic interest.
+
|- class="odd"
 +
| class="sshl_f" | 2
 +
| class="sshl_f" |
  
−
'''Formula''':-
+
|- class="even"
−
 
+
| class="sshl_f" | 0
−
If 1 coupon period or less than Redemption
+
| class="sshl_f" |
−
 
+
|}
−
YIELD={[(Redemption/100)+(Rate/Frequency)]-
 
−
 
 
−
[(Par/100)+((B/C) x (Rate/Frequency))]} /    [(Par/100)+((A/C) x (Rate/Frequency))] x( Frequeny x C)/N
 
−
 
 
−
where,
 
−
 
 
−
B - number of daysfrom the beginning of the period to the settlement date.
 
−
 
 
−
C - number of days in the coupon period.
 
  
−
N - number of days from settlement to redemption value.
+
=YIELD(A1,A2,A3,A4,A5,A6,A7) : Calculates the Yield Value with the inputs in the range A1 to A7. Returns '''6.2%''' as a result.
  
−
</div>
+
=YIELD(DATE(2012,6,10), DATE(2013,6,10), "6%", 98.85, 100, 2) : Calculates the Yield Value with the inputs. <br /> Returns '''7.21%''' as a result.
−
----
 
−
<div id="7SpaceContent" class="zcontent" align="left">
 
  
−
If Basis &lt; 0 or Basis &gt; 4 , YIELD returns the #ERROR.
+
==Related Videos==
  
−
If Rate &lt; 0 or Price &lt;= 0 or Redemption &lt;=0, it returns the #ERROR.
+
{{#ev:youtube|vi27yLPgwZc|280|center|YIELD}}
  
−
If SettlementDate &gt;= MaturityDate, YIELD returns #ERROR.
+
== See Also ==
  
−
If Frequency other than 1, 2 or 4 returns the #ERROR.
+
*[[Manuals/calci/YIELDDISC | YIELDDISC]]
 +
*[[Manuals/calci/YIELDMAT | YIELDMAT]]
  
−
</div>
+
== References ==
−
----
 
−
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
  
−
YIELD
+
*[http://en.wikipedia.org/wiki/Yield_(finance) Yield]
 +
*[http://en.wikipedia.org/wiki/Current_yield Current Yield]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention]
  
−
</div></div>
 
−
----
 
−
<div id="8SpaceContent" class="zcontent" align="left">
 
  
−
Lets see an example in (Column2, Row1)
 
  
−
<nowiki>=YIELD(R1C1, R2C1, R3C1, R4C1, R5C1,R6C1,R7C1)</nowiki>
+
*[[Z_API_Functions | List of Main Z Functions]]
−
 
 
−
YIELD returns 47.950201.
 
−
 
 
−
Consider another example
 
−
 
 
−
<nowiki>=YIELD(date(2007,1,1), date(2008,2,20), "15%", 89.25,100,1,5)</nowiki>
 
−
 
 
−
It returns #ERROR(Basis=5).
 
−
 
 
−
</div>
 
−
----
 
−
<div id="10SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Syntax </div><div class="ZEditBox"><center></center></div></div>
 
−
----
 
−
<div id="4SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Remarks </div></div>
 
−
----
 
−
<div id="3SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Examples </div></div>
 
−
----
 
−
<div id="11SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Description </div></div>
 
−
----
 
−
<div id="2SpaceContent" class="zcontent" align="left">
 
−
 
 
−
{| id="TABLE3" class="SpreadSheet blue"
 
−
|- class="even"
 
−
| class="    " |
 
−
<div id="2EditDiv" class="tab active"></div><div id="2Space_Copy" class="zhandles"></div>
 
−
| class="  " | Column1
 
−
| class="  " | Column2
 
−
| Column3
 
−
| Column4
 
−
|- class="odd"
 
−
| class=" " | Row1
 
−
| class=" " | 1/2/2008
 
−
| class="sshl_f" | 47.950201
 
−
| class="                                        " |
 
−
| class="      sshl_f  " |
 
−
|- class="even"
 
−
| class="  " | Row2
 
−
| class=" " | 2/20/2008
 
−
| class="                          sshl_f  " |
 
−
| class=" " |
 
−
| class=" " |
 
−
|- class="odd"
 
−
| Row3
 
−
| class=" " | 12%
 
−
| class=" " |
 
−
| class="  SelectTD  SelectTD ChangeBGColor" |
 
−
<div id="2Space_Handle" class="zhandles" title="Click and Drag to resize CALCI Column/Row/Cell. It is EZ!"></div><div id="2Space_Copy" class="zhandles" title="Click and Drag over to AutoFill other cells."></div><div id="2Space_Drag" class="zhandles" title="Click and Drag to Move/Copy Area.">[[Image:copy-cube.gif]]  </div>
 
−
| class=" " |
 
−
|- class="even"
 
−
| Row4
 
−
| class=" " | 56.268
 
−
| class=" " |
 
−
| class=" " |
 
−
| class=" " |
 
−
|- class="odd"
 
−
| class=" " | Row5
 
−
| class=" " | 100
 
−
| class=" " |
 
−
| class=" " |
 
−
| class=" " |
 
−
|- class="even"
 
−
| class="sshl_f" | Row6
 
−
| class=" " | 1
 
−
| class=" " |
 
−
| class=" " |
 
−
| class=" " |
 
−
|- class="odd"
 
−
| class="sshl_f" | Row7
 
−
| class="sshl_f " | 4
 
−
| class="    " |
 
−
| class="  " |
 
−
| class="  " |
 
−
|}
 
  
−
<div align="left">[[Image:calci1.gif]]</div></div>
+
*[[ Z3 |  Z3 home ]]
−
----
 

Latest revision as of 16:32, 22 August 2018

YIELD (Settlement,MaturityDate,Rate,Price,RedemptionValue,Frequency,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 MaturityDate} 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 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 RedemptionValue} is security's redemption value 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 Frequency} is the number of coupon payments per year, 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 Basis} is the type of day count basis to use.
    • YIELD(), returns the yield on a security that pays periodic interest.

Description

YIELD (Settlement,MaturityDate,Rate,Price,RedemptionValue,Frequency,Basis)

  • Yield is the annual percentage return on an investment or security. Yield is the value obtained by dividing Annual Interest by Bond Price.

Formula:- 

If B= Number of days from beginning of coupon period to settlement date,
   C= Number of days in coupon period,
   N= Number of days from settlement date to redemption date

: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 YIELD = \dfrac{(\dfrac{redemption}{100}+\dfrac{rate}{frequency})-(\dfrac{par}{100}+(\dfrac{B}{C}*\dfrac{rate}{frequency}))}{\dfrac{par}{100}+(\dfrac{B}{C}*\dfrac{rate}{frequency})}*\dfrac{frequency*C}{N}}
  • 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} 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 MaturityDate} 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 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} date = 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 MaturityDate} date, 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} 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 Redemption} values must be greater than zero, else Calci displays #N/A error message.
  • The values for 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 Frequency} should be 1,2 or 4.

For Annual payment, 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 Frequency} = 1,

For Semi-annual payment, 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 Frequency} = 2,

For Quarterly payment, 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 Frequency} = 4.

  • 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 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

YIELD (Settlement,MaturityDate,Rate,Price,RedemptionValue,Frequency,Basis) function with inputs in order is calculated as follows:

2/2/2008
11/2/2010
5%
97
$100
2
0 
=YIELD(A1,A2,A3,A4,A5,A6,A7) : Calculates the Yield Value with the inputs in the range A1 to A7. Returns 6.2% as a result.

=YIELD(DATE(2012,6,10), DATE(2013,6,10), "6%", 98.85, 100, 2) : Calculates the Yield Value with the inputs. 
 Returns 7.21% as a result.

Related Videos

YIELD

See Also

References


Retrieved from "http://wiki.zcubes.com/index.php?title=Manuals/calci/YIELD&oldid=211191"