Practice free

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.

Practice this in the app

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.

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