YIELDMAT function
the annual yield of a security that pays interest at maturity.
Financial · Guided Excel example
Where can you use it?
Budgeting, treasury and finance teams. When reviewing a scenario with cash flows, payment periods and rate assumptions, compare the input and output units in the example.
Scenario in the workbook
Compare maturity proceeds with the purchase price. Yield is zero when the price equals the proceeds.
A worked example from the workbook
| Row | A |
|---|---|
| 6 | Input |
| 7 | 100 |
| 8 | 105 |
| 9 | 95 |
Record 1
=YIELDMAT(DATE(2026,1,1),DATE(2027,1,1),DATE(2026,1,1),0.05,A7,3)Illustrative output0.05
See the inputs and instructions for all 3 examplesSyntax
YIELDMAT(settlement, maturity, issue, rate, pr, [basis])
Worked examples
Compare maturity proceeds with the purchase price. Yield is zero when the price equals the proceeds.
Column F provides expressions as text. Satisfy the stated requirements, then paste into an empty Excel cell and compare with column G. The result was not verified in desktop Excel here.
| Row | A |
|---|---|
| 6 | Input |
| 7 | 100 |
| 8 | 105 |
| 9 | 95 |
| Trial | Expression | Sample output |
|---|---|---|
| Record 1 | =YIELDMAT(DATE(2026,1,1),DATE(2027,1,1),DATE(2026,1,1),0.05,A7,3) |
0.05 |
| Record 2 | =YIELDMAT(DATE(2026,1,1),DATE(2027,1,1),DATE(2026,1,1),0.05,A8,3) |
0 |
| Record 3 | =YIELDMAT(DATE(2026,1,1),DATE(2027,1,1),DATE(2026,1,1),0.05,A9,3) |
0.1052631579 |