Manuals/calci/DURATION

DURATION (Settlement,Maturity,Coupon,Yield,Frequency,Basis)

Where $Settlement$ is the security's settlement date (a date when coupon or a bond is purchased),
$Maturity$ is the security's maturity date (a date when coupon or a bond expires),
$Coupon$ is the security's annual coupon rate,
$Yield$ is the security's annual yield,
$Frequency$ 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.

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.

$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.
If $Settlement$ date ≥ $Maturity$ date, Calci displays #N/A error message.
$Coupon$ and $Yield$ values must be greater than or equal to zero.
The values for $Frequency$ should be 1,2 or 4.

For Annual payment, frequency = 1,

For Semi-annual payment, frequency = 2,

For Quarterly payment, frequency = 4.

Below table shows the use of $Basis$ values:

Consider the following example that shows the use of DURATION function:

=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.