DURATION function
DURATION returns a bond's Macaulay duration in years, the weighted average time until its cash flows arrive. Bond analysts use it to gauge sensitivity to interest-rate moves.
Example
Read it as a sentence: for a bond bought January 1, 2024 that matures January 1, 2029, with an 8% coupon, a 9% yield and two payments a year, find how long on average it takes to get your money back, using basis 0.
Syntax
DURATION(settlement, maturity, coupon, yld, frequency, [basis])
Arguments in [square brackets] are optional.
-
settlement(required) - Date the security is bought (after issue, before maturity).
-
maturity(required) - Date the security expires and is repaid.
-
coupon(required) - Annual coupon rate.
-
yld(required) - Annual yield.
-
frequency(required) - Coupon payments per year: 1 annual, 2 semiannual, 4 quarterly.
-
basis(optional) - Day-count convention: 0 or omitted = US 30/360, 1 = actual/actual, 2 = actual/360, 3 = actual/365, 4 = European 30/360.
Returns: Macaulay duration in years.
What Excel actually returns
Each formula below was run in desktop Excel. The result is exactly what the cell showed, errors included.
| Formula | Excel shows | Case |
|---|---|---|
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,2,0) | 7.12444046 | Typical |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,2) | 7.12444046 | Basis omitted |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,1,0) | 7.33317423 | Frequency 1 |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,4,0) | 7.168925415 | Frequency 4 |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,2.9,0) | 7.12444046 | Frequency 2.9 truncates |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,2,0) | 7.12444046 | Basis 0 |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,3,0) | #NUM! | Frequency 3 |
=DURATION(DATE(2024,2,15),DATE(2034,11,15),0.08,0.09,0,0) | #NUM! | Frequency 0 |
Watch out for
- Do not confuse it with PDURATION, which is what Google Sheets calls DURATION.
Where it works
- Excel
- DURATION is in every version of Excel from 2007 on.
- Google Sheets
- Same name, same behaviour for everyday use.
Part of Financial functions. Every result on this page was measured in desktop Excel, build 16.0.20527. Last updated .