Difference between revisions of "Manuals/calci/PRICE"

From ZCubes Wiki
Jump to navigation Jump to search
Line 1: Line 1:
 
=PRICE(settlement, maturity, rate, yield, redemption, frequency, basis)=
 
=PRICE(settlement, maturity, rate, yield, redemption, frequency, basis)=
  
*where 'settlement' 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),  
*'maturity' 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),  
*'rate' is security's annual coupon rate,  
+
*<math>rate</math> is security's annual coupon rate,  
*'yield' is security's annual yield,
+
*<math>yield</math> is security's annual yield,
*'redemption' is security's redemption value per &#36;100 face value,
+
*<math>redemption</math> is security's redemption value per &#36;100 face value,
*'frequency' is the number of coupon payments per year, and  
+
*<math>frequency</math> is the number of coupon payments per year, and  
*'basis' is the type of day count basis to use.
+
*<math>basis</math> is the type of day count basis to use.
  
 
PRICE() calculates the price per &#36;100 face value of security that pays periodic interest.
 
PRICE() calculates the price per &#36;100 face value of security that pays periodic interest.
Line 16: Line 16:
  
 
*The function returns the price per &#36;100 face value of security that pays periodic interest.
 
*The function returns the price per &#36;100 face value of security that pays periodic interest.
*Settlement and maturity 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 settlement date ≥ maturity date, Calci displays #N/A error message.
+
*If <math>settlement</math> date ≥ <math>maturity</math> date, Calci displays #N/A error message.
*'rate' and 'yield' values must be greater than or equal to zero, else Calci displays #N/A error message.
+
*<math>rate</math> and <math>yield</math> values must be greater than or equal to zero, else Calci displays #N/A error message.
*'redemption' value must be greater than zero, else Calci displays #N/A error message.
+
*<math>redemption</math> value must be greater than zero, else Calci displays #N/A error message.
*The values for 'frequency' should be 1,2 or 4.  
+
*The values for <math>frequency</math> should be 1,2 or 4.  
 
For Annual payment, frequency = 1,
 
For Annual payment, frequency = 1,
  
Line 27: Line 27:
 
For Quarterly payment, frequency = 4.
 
For Quarterly payment, frequency = 4.
  
*'basis' 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 'basis' values:
 
Below table shows the use of 'basis' values:
  
Line 45: Line 45:
 
|}
 
|}
  
*If 'basis' 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 ==

Revision as of 17:06, 13 December 2013

PRICE(settlement, maturity, rate, yield, redemption, frequency, 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 annual coupon rate,
  • is security's annual yield,
  • is security's redemption value per $100 face value,
  • is the number of coupon payments per year, and
  • is the type of day count basis to use.

PRICE() calculates the price per $100 face value of security that pays periodic interest.

Description

PRICE(settlement, maturity, rate, yield, redemption, frequency, basis)

  • The function returns the price per $100 face value of security that pays periodic interest.
  • 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 or equal to zero, else Calci displays #N/A error message.
  • value must be greater than zero, else Calci displays #N/A error message.
  • The values for should be 1,2 or 4.

For Annual payment, frequency = 1,

For Semi-annual payment, frequency = 2,

For Quarterly payment, frequency = 4.

  • value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of 'basis' values:

Basis Description
0 US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/365
  • If value is other than 0 to 4, Calci displays #N/A error message.

Examples

PRICE(settlement, maturity, rate, yield, redemption, frequency, basis) function with inputs in order is calculated as follows:

2/2/2008
11/2/2016
5%
8%
$100
2
0
=PRICE(A1,A2,A3,A4,A5,A6,A7) : Calculates the Price Value with the inputs in the range A1 to A7. Returns 81.36538958112115.

See Also

References