DURATION function
Returns the annual duration of a security with periodic interest payments
Syntax
DURATION(settlement, maturity, coupon, yld, frequency, [basis])Square brackets indicate optional arguments.
Arguments
| Argument | Required | Meaning |
|---|---|---|
| settlement | Yes | The security's settlement date."2018-7-1" |
| maturity | Yes | The security's maturity date."2048-1-1" |
| coupon | Yes | The security's annual coupon rate.8% |
| yld | Yes | The security's annual yield.9% |
| frequency | Yes | The number of coupon payments per year.2 |
| basis | No | The type of day count basis to use.1 |
Try DURATION
Weight the timing of discounted bond payments
=DURATION(A2,B2,C2,D2,2,0)Multiply each discounted payment by its time in years (0.5,1,1.5,2), sum those products, then divide by the clean price. This gives Macaulay duration in years, not the maturity date or percentage return. The coupon-date setup avoids an accrued-interest adjustment.
Inspect the current formula
Read its written arguments or observe actual operation values in a separate local calculation. This action neither applies a draft nor grades an answer.
Read the formula, one argument at a time
Explore the written function calls and their inputs. The calculation result belongs to the complete formula.
DURATION · top-level call
=DURATION(A2,B2,C2,D2,2,0)Follow the cells behind a result
Read explicit local references and helper formulas using a separate calculation. Your draft stays in this field; the worksheet and practice checks do not change.
The worksheet runs locally. Published checks apply to the supplied example only. Native Excel and Google Sheets compatibility remain unverified.
Practice a complete task
Reference and compatibility
Univer 1.0.4 / Apache-2.0. Calculation checks cover the supplied examples only. The browser worksheet does not implement every Excel feature, external service or connected data type.