# Documentation/Calc Functions/DURATION

Jump to navigation Jump to search

DURATION

## Category:

Financial Analysis

## Summary:

Calculates the Macaulay duration of a fixed interest security in years.

## Syntax:

DURATION(Settlement; Maturity; Coupon; Yield; Frequency[; Basis])

## Returns:

Returns a positive real number which is the Macaulay duration of fixed interest security in years.

## Arguments:

Settlement is a date or a reference to a cell containing that date which is the date of purchase of the security.

Maturity is a date or a reference to a cell containing that date which is the date on which the security matures (expires).

Coupon is a positive real number or a reference to the cell containing that number which is the annual coupon interest rate (nominal rate of interest).

Yield is a positive real number or a reference to the cell containing that number which is the annual yield of the security.

Frequency is a positive integer or a reference to a cell containing that integer which is the number of interest payments per year (1, 2 or 4).

Frequency Frequency
1 Annual
2 Semiannual
4 Quarterly

Basis is a positive integer from 0 to 4 or a reference to a cell containing that integer which is chosen from a list of options and indicates how the year is to be calculated. For more information, visit Wikipedia's Day count convention page.

Basis Calculation
0 or missing US method (NASD), 12 months of 30 days each
1 Exact number of days in months, exact number of days in year.
2 Exact number of days in month, year has 360 days.
3 Exact number of days in month, year has 365 days.
4 European method, 12 months of 30 days each.

• If either Yield or Coupon is less than 0 then the function returns an error value.
• If either Settlement or Maturity are not valid dates then the function returns an value(#VALUE!) error.
• If Settlement date is after the Maturity date then the function returns an error value.
• If Frequency, and Basis are non-integer values, then the function uses their floor value, i.e. they are truncated to an integer value.
• After truncation if Frequency is any number except 1,2 or 4, then the function returns an error value.
• After truncation if Basis is ny number except 0,1,2,3,4 or missing(passed as empty argument or not passed at all),then the function will return an error value.

None

## Examples:

Formula Description Returns
=DURATION("2001-01-01";"2006-01-01";0.08;0.09;2;3) A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The Coupon rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) the function finds how long is the duration. 4.20161802829783
=DURATION("2001-01-01";"2006-01-01";0.08;0.09;2) A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The Coupon rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 0 by default) the function finds how long is the duration. 4.19887830227043
=DURATION("2001-01-01.05";"2006-01-01";0.08;0.09;2;3) The function returns an error value if either Settlement or Maturity are not valid dates. #VALUE!
=DURATION("2007-01-01";"2006-01-01";0.08;0.09;2;3) The function returns an error when Settlement date is after the Maturity date. Err:502

DURATION