returns the Macaulay duration of a security · from excel · excel: verified match · sheets: verified match

signature

DURATION(settlement, maturity, coupon, yld, frequency, [basis])

returns: number

argument	required
settlement	required
maturity	required
coupon	required
yld	required
frequency	required
basis	optional

examples

formula and result, taken from the engine's own test suite — every result below is asserted in CI, not written by hand.

errors

error values observed from the engine — each with a call that produces it.

error	produced by
#ERROR!	=DURATION(1, 2, 3, 4)

related

• ACCRINT accrued interest for a security paying periodic interest
• ACCRINTM accrued interest for a security paying at maturity
• AMORDEGRC depreciation per period, French accounting, degressive
• AMORLINC depreciation per period, French accounting, linear
• COUPDAYBS days from coupon period start to settlement
• COUPDAYS days in the coupon period containing settlement