Difference between revisions of "Manuals/calci/DURATION"
Jump to navigation
Jump to search
| (12 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | =DURATION(settlement, maturity, coupon, yield, | + | <div style="font-size:30px">'''DURATION (Settlement,Maturity,Coupon,Yield,Frequency,Basis)'''</div><br/> |
| + | *Where <math>Settlement</math> is the security's settlement date (a date when coupon or a bond is purchased), | ||
| + | *<math>Maturity</math> is the security's maturity date (a date when coupon or a bond expires), | ||
| + | *<math>Coupon</math> is the security's annual coupon rate, | ||
| + | *<math>Yield</math> is the security's annual yield, | ||
| + | *<math>Frequency</math> is the number of coupon payments per year, and | ||
| + | *<math>Basis</math> is the type of day count basis to use. | ||
| + | **DURATION(), returns the annual duration of a security with periodic interest payments. | ||
| − | + | == Description == | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | DURATION() | + | DURATION(Settlement, Maturity, Coupon, Yield, Frequency, Basis) |
| − | |||
| − | |||
| − | DURATION( | + | DURATION() calculates the rate of change of price with respect to yields. It is the weighted average time until cash flows are received. |
| − | *If | + | *<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 | + | *If <math>Settlement</math> date ≥ <math>Maturity</math> date, Calci displays #N/A error message. |
| − | * | + | *<math>Coupon</math> and <math>Yield</math> values must be greater than or equal to zero. |
| − | *The values for | + | *The values for <math>Frequency</math> should be 1,2 or 4. |
For Annual payment, frequency = 1, | For Annual payment, frequency = 1, | ||
| Line 24: | Line 24: | ||
For Quarterly payment, frequency = 4. | For Quarterly payment, frequency = 4. | ||
| − | * | + | *<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0. |
| − | Below table shows the use of | + | Below table shows the use of <math>Basis</math> values: |
{| class="wikitable" | {| class="wikitable" | ||
| Line 42: | Line 42: | ||
|} | |} | ||
| − | *If | + | *If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message. |
== Examples == | == Examples == | ||
| Line 52: | Line 52: | ||
{| id="TABLE3" class="SpreadSheet blue" | {| id="TABLE3" class="SpreadSheet blue" | ||
|- class="even" | |- class="even" | ||
| + | | class="sshl_f" | | ||
| + | | class="sshl_f" | A | ||
| + | | class="sshl_f" | B | ||
| + | | class="sshl_f" | C | ||
| + | |||
| + | |- class="odd" | ||
| + | | class="sshl_f" | 1 | ||
| class=" " | September 10, 2010 | | class=" " | September 10, 2010 | ||
| class=" " | | | class=" " | | ||
| class=" " | | | class=" " | | ||
| − | |- class=" | + | |- class="even" |
| + | | class="sshl_f" | 2 | ||
| class="sshl_f" | September 10, 2016 | | class="sshl_f" | September 10, 2016 | ||
| class=" " | | | class=" " | | ||
| class=" " | | | class=" " | | ||
| − | |- class=" | + | |- class="odd" |
| + | | class="sshl_f" | 3 | ||
| class=" " | 6% | | class=" " | 6% | ||
| class=" " | | | class=" " | | ||
| class=" " | | | class=" " | | ||
| − | |- class=" | + | |- class="even" |
| + | | class="sshl_f" | 4 | ||
| class=" " | 9.0% | | class=" " | 9.0% | ||
| class=" " | | | class=" " | | ||
| class=" " | | | class=" " | | ||
| − | |- class=" | + | |- class="odd" |
| + | | class="sshl_f" | 5 | ||
| class=" " | 2 | | class=" " | 2 | ||
| class=" " | | | class=" " | | ||
| class=" " | | | class=" " | | ||
| − | |- class=" | + | |- class="even" |
| + | | class="sshl_f" | 6 | ||
| class=" " | 1 | | class=" " | 1 | ||
| class=" " | | | class=" " | | ||
| Line 83: | Line 95: | ||
|} | |} | ||
| − | =DURATION(A1,A2,A3,A4,A5,A6) '' | + | =DURATION(A1,A2,A3,A4,A5,A6) displays '''5.045790027952841''' as a result. |
| + | =DURATION(DATE(2013,6,1),DATE(2013,12,31),"6%","8%",1,1) displays '''1''' as a result. | ||
| + | |||
| + | ==Related Videos== | ||
| + | |||
| + | {{#ev:youtube|E9qTbAObZzY|280|center|DURATION}} | ||
| + | |||
| + | == See Also == | ||
| + | |||
| + | *[[Manuals/calci/MDURATION | MDURATION]] | ||
| + | |||
| + | == References == | ||
| + | |||
| + | *[http://en.wikipedia.org/wiki/Bond_duration#Macaulay_duration Macaulay Duration] | ||
| + | *[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis] | ||
| + | |||
| + | |||
| + | *[[Z_API_Functions | List of Main Z Functions]] | ||
| + | |||
| + | *[[ Z3 | Z3 home ]] | ||
Latest revision as of 17:11, 22 August 2018
DURATION (Settlement,Maturity,Coupon,Yield,Frequency,Basis)
- Where is the security's settlement date (a date when coupon or a bond is purchased),
- is the security's maturity date (a date when coupon or a bond expires),
- is the security's annual coupon rate,
- is the security's annual yield,
- is the number of coupon payments per year, and
- is the type of day count basis to use.
- DURATION(), returns the annual duration of a security with periodic interest payments.
is the security's settlement date (a date when coupon or a bond is purchased),
is the security's maturity date (a date when coupon or a bond expires),
is the security's annual coupon rate,
is the security's annual yield,
is the number of coupon payments per year, and
is the type of day count basis to use.
Description
DURATION(Settlement, Maturity, Coupon, Yield, Frequency, Basis)
DURATION() calculates the rate of change of price with respect to yields. It is the weighted average time until cash flows are received.
- 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.
- 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 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
Consider the following example that shows the use of DURATION function:
| A | B | C | |
| 1 | September 10, 2010 | ||
| 2 | September 10, 2016 | ||
| 3 | 6% | ||
| 4 | 9.0% | ||
| 5 | 2 | ||
| 6 | 1 |
=DURATION(A1,A2,A3,A4,A5,A6) displays 5.045790027952841 as a result. =DURATION(DATE(2013,6,1),DATE(2013,12,31),"6%","8%",1,1) displays 1 as a result.
Related Videos
See Also
References