ExcelFlux

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

RowA
6Input
7100
8105
995
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 examples

Syntax

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
Microsoft Excel reference