← All functions

YIELDMAT

Quirk found

Category: Financial · Last tested 2026-09-01

Real compatibility results for the YIELDMAT function: executed in Excel for the web, Google Sheets and LibreOffice Calc, with desktop Excel behavior from Microsoft’s official documentation (we do not run desktop Excel — Excel for the web is a different application and is executed separately). Syntax and links to that documentation are below.

Support matrix

EngineDocumentedLive-testedVerdict
Excel (desktop)Yes No — documented only n/a
Excel for the web— Yes (recalc, 2026-09-01) Supported, behaves as documented
Google SheetsYes Yes (Drive import, 2026-08-31) Supported, behaves as documented
LibreOffice CalcYes Yes (25.8.7.3, 2026-08-31) Quirk found

LibreOffice version history

We executed the same test cases under each LibreOffice release to show exactly when YIELDMAT’s support changed — not documentation claims, real results.

LibreOffice versionVerdictTested
24.2.0.3 Quirk found 2026-08-31
24.8.7.2 Quirk found 2026-08-31
25.2.0.3 Quirk found 2026-08-31
25.8.7.3 Quirk found 2026-08-31

Why isn't YIELDMAT working in LibreOffice?

YIELDMAT exists in LibreOffice 25.8.7.3, but it is not a drop-in match for Excel — our executed tests found real behavioral differences (detailed in the test results on this page). If a formula that works in Excel or Google Sheets misbehaves in LibreOffice, compare your usage against the failing cases above before assuming your data is wrong.

Discovered quirks

Executed test cases

Excel for the web (executed 2026-09-01 via OneDrive recalculation)

These values come from Excel for the web, not from desktop Excel. They are two different implementations of the calculation engine, and this run measured only the web one: the corpus was uploaded to OneDrive as .xlsx, recalculated by Excel for the web on open, and downloaded again for readback. Excel for the web is a rolling service with no pinnable version, so the run is identified by its date. Where a value here disagrees with the Expected column — which is Microsoft’s documentation of the desktop product — we cannot tell you whether the web engine diverges from the desktop one or the documentation is wrong about both, because we do not run desktop Excel.

FormulaDescriptionResultExpectedVerdict
=ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),6) Microsoft's documented worked example, at the six decimals its description publishes 0.060954 0.060954
Provenance

Microsoft publishes =YIELDMAT(A2,A3,A4,A5,A6,A7) with the description "The yield, for the bond with the terms above (0.060954 or 6.10%)" and a Result cell formatted as "6.10%". Settlement 2008-03-15 (serial 39522), maturity 2008-11-03 (serial 39755), issue 2007-11-08 (serial 39394), 6.25% semiannual coupon, price 100.0123, 30/360 basis. DERIVATION -- THE PAGE PRINTS NO FORMULA (every image in the article body was enumerated and there are none): the closed form for a security paying interest at maturity is ((1 + DIM/B*rate) - (pr/100 + DIS/B*rate)) / (pr/100 + DIS/B*rate) * B/DSM, where DIM is issue-to-maturity, DIS is issue-to-settlement and DSM is settlement-to-maturity, all on the given basis. On basis 0 those are DIM = 355, DIS = 127 and DSM = 228 days with B = 360, giving 0.06095433369153852071011, i.e. 0.060954 at the published precision. Day counts come from a clean-room implementation of OpenFormula 1.3 section 4.11.7 (Procedure A for US 30/360, Procedure B for actual days, Procedure C for European 30/360, D/E/F for days-in-year) written for this batch and used by no engine; the bond arithmetic is evaluated over exact rational day-count ratios at 50 digits with mpmath. Microsoft's page was read live on 2026-08-31 at https://support.microsoft.com/en-us/excel/functions/yieldmat-function. FETCH NOTE FOR THIS BATCH: batch F recorded every /en-us/office/<name>-function-<guid> URL returning Microsoft's 'Sorry, the page you're looking for can't be found' body; today BOTH paths serve the article again -- the GUID form redirects to /en-us/excel/functions/<slug>-function -- and every page cited in this batch came back complete (217-223 KB) in one or two attempts, with no 87 KB stub responses. Nothing here is sourced from a search snippet or a mirror.

Matched
=ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),10) The same example carried to ten decimals 0.0609543337 0.0609543337
Provenance

Asserted at ten places from the derivation: 0.0609543337. Six published decimals cannot separate the three separate day counts this function needs -- DIM, DIS and DSM are 355, 127 and 228 here, and getting any one of them wrong by a day or two still lands near 0.0610.

Matched
=YIELDMAT(A3,A2,A4,A5,A6,A7) The dates reversed, which the page excludes #NUM! #NUM!
Provenance

The Remarks publish: "If settlement >= maturity, YIELDMAT returns the #NUM! error value."

Matched
=YIELDMAT(A2,A3,A4,-0.01,A6,A7) A negative coupon rate, which the page excludes #NUM! #NUM!
Provenance

The Remarks publish: "If rate < 0 or if pr <= 0, YIELDMAT returns the #NUM! error value."

Matched
=YIELDMAT(A2,A3,A4,A5,0,A7) A price of zero, which the page excludes #NUM! #NUM!
Provenance

The second half of the same Remark: pr <= 0 is a #NUM!.

Matched
=YIELDMAT(A2,A3,A4,A5,A6,5) A basis of 5, which is outside the documented table #NUM! #NUM!
Provenance

The Remarks publish: "If basis < 0 or if basis > 4, YIELDMAT returns the #NUM! error value."

Matched
=YIELDMAT(A2,A3,"not a date",A5,A6,A7) A non-date issue argument #VALUE! #VALUE!
Provenance

The Remarks publish: "If settlement, maturity, or issue is not a valid date, YIELDMAT returns the #VALUE! error value." The issue date is asserted rather than the settlement date because issue is the argument this function has and its YIELD/YIELDDISC siblings do not.

Matched

Google Sheets (executed 2026-08-31 via Drive import)

Google Sheets is a rolling service with no pinnable version, so this run is identified by its date. The corpus was imported to Drive as .xlsx, recalculated by Sheets, and exported back for readback.

FormulaDescriptionResultExpectedVerdict
=ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),6) Microsoft's documented worked example, at the six decimals its description publishes 0.060954 0.060954
Provenance

Microsoft publishes =YIELDMAT(A2,A3,A4,A5,A6,A7) with the description "The yield, for the bond with the terms above (0.060954 or 6.10%)" and a Result cell formatted as "6.10%". Settlement 2008-03-15 (serial 39522), maturity 2008-11-03 (serial 39755), issue 2007-11-08 (serial 39394), 6.25% semiannual coupon, price 100.0123, 30/360 basis. DERIVATION -- THE PAGE PRINTS NO FORMULA (every image in the article body was enumerated and there are none): the closed form for a security paying interest at maturity is ((1 + DIM/B*rate) - (pr/100 + DIS/B*rate)) / (pr/100 + DIS/B*rate) * B/DSM, where DIM is issue-to-maturity, DIS is issue-to-settlement and DSM is settlement-to-maturity, all on the given basis. On basis 0 those are DIM = 355, DIS = 127 and DSM = 228 days with B = 360, giving 0.06095433369153852071011, i.e. 0.060954 at the published precision. Day counts come from a clean-room implementation of OpenFormula 1.3 section 4.11.7 (Procedure A for US 30/360, Procedure B for actual days, Procedure C for European 30/360, D/E/F for days-in-year) written for this batch and used by no engine; the bond arithmetic is evaluated over exact rational day-count ratios at 50 digits with mpmath. Microsoft's page was read live on 2026-08-31 at https://support.microsoft.com/en-us/excel/functions/yieldmat-function. FETCH NOTE FOR THIS BATCH: batch F recorded every /en-us/office/<name>-function-<guid> URL returning Microsoft's 'Sorry, the page you're looking for can't be found' body; today BOTH paths serve the article again -- the GUID form redirects to /en-us/excel/functions/<slug>-function -- and every page cited in this batch came back complete (217-223 KB) in one or two attempts, with no 87 KB stub responses. Nothing here is sourced from a search snippet or a mirror.

Matched
=ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),10) The same example carried to ten decimals 0.0609543337 0.0609543337
Provenance

Asserted at ten places from the derivation: 0.0609543337. Six published decimals cannot separate the three separate day counts this function needs -- DIM, DIS and DSM are 355, 127 and 228 here, and getting any one of them wrong by a day or two still lands near 0.0610.

Matched
=YIELDMAT(A3,A2,A4,A5,A6,A7) The dates reversed, which the page excludes #NUM! #NUM!
Provenance

The Remarks publish: "If settlement >= maturity, YIELDMAT returns the #NUM! error value."

Matched
=YIELDMAT(A2,A3,A4,-0.01,A6,A7) A negative coupon rate, which the page excludes #NUM! #NUM!
Provenance

The Remarks publish: "If rate < 0 or if pr <= 0, YIELDMAT returns the #NUM! error value."

Matched
=YIELDMAT(A2,A3,A4,A5,0,A7) A price of zero, which the page excludes #NUM! #NUM!
Provenance

The second half of the same Remark: pr <= 0 is a #NUM!.

Matched
=YIELDMAT(A2,A3,A4,A5,A6,5) A basis of 5, which is outside the documented table #NUM! #NUM!
Provenance

The Remarks publish: "If basis < 0 or if basis > 4, YIELDMAT returns the #NUM! error value."

Matched
=YIELDMAT(A2,A3,"not a date",A5,A6,A7) A non-date issue argument #VALUE! #VALUE!
Provenance

The Remarks publish: "If settlement, maturity, or issue is not a valid date, YIELDMAT returns the #VALUE! error value." The issue date is asserted rather than the settlement date because issue is the argument this function has and its YIELD/YIELDDISC siblings do not.

Matched

LibreOffice Calc 25.8.7.3 (tested 2026-08-31)

FormulaDescriptionResultExpectedVerdict
=ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),6) Microsoft's documented worked example, at the six decimals its description publishes 0.060954 0.060954
Provenance

Microsoft publishes =YIELDMAT(A2,A3,A4,A5,A6,A7) with the description "The yield, for the bond with the terms above (0.060954 or 6.10%)" and a Result cell formatted as "6.10%". Settlement 2008-03-15 (serial 39522), maturity 2008-11-03 (serial 39755), issue 2007-11-08 (serial 39394), 6.25% semiannual coupon, price 100.0123, 30/360 basis. DERIVATION -- THE PAGE PRINTS NO FORMULA (every image in the article body was enumerated and there are none): the closed form for a security paying interest at maturity is ((1 + DIM/B*rate) - (pr/100 + DIS/B*rate)) / (pr/100 + DIS/B*rate) * B/DSM, where DIM is issue-to-maturity, DIS is issue-to-settlement and DSM is settlement-to-maturity, all on the given basis. On basis 0 those are DIM = 355, DIS = 127 and DSM = 228 days with B = 360, giving 0.06095433369153852071011, i.e. 0.060954 at the published precision. Day counts come from a clean-room implementation of OpenFormula 1.3 section 4.11.7 (Procedure A for US 30/360, Procedure B for actual days, Procedure C for European 30/360, D/E/F for days-in-year) written for this batch and used by no engine; the bond arithmetic is evaluated over exact rational day-count ratios at 50 digits with mpmath. Microsoft's page was read live on 2026-08-31 at https://support.microsoft.com/en-us/excel/functions/yieldmat-function. FETCH NOTE FOR THIS BATCH: batch F recorded every /en-us/office/<name>-function-<guid> URL returning Microsoft's 'Sorry, the page you're looking for can't be found' body; today BOTH paths serve the article again -- the GUID form redirects to /en-us/excel/functions/<slug>-function -- and every page cited in this batch came back complete (217-223 KB) in one or two attempts, with no 87 KB stub responses. Nothing here is sourced from a search snippet or a mirror.

Matched
=ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),10) The same example carried to ten decimals 0.0609543337 0.0609543337
Provenance

Asserted at ten places from the derivation: 0.0609543337. Six published decimals cannot separate the three separate day counts this function needs -- DIM, DIS and DSM are 355, 127 and 228 here, and getting any one of them wrong by a day or two still lands near 0.0610.

Matched
=YIELDMAT(A3,A2,A4,A5,A6,A7) The dates reversed, which the page excludes #VALUE! #NUM!
Provenance

The Remarks publish: "If settlement >= maturity, YIELDMAT returns the #NUM! error value."

Mismatch
=YIELDMAT(A2,A3,A4,-0.01,A6,A7) A negative coupon rate, which the page excludes #VALUE! #NUM!
Provenance

The Remarks publish: "If rate < 0 or if pr <= 0, YIELDMAT returns the #NUM! error value."

Mismatch
=YIELDMAT(A2,A3,A4,A5,0,A7) A price of zero, which the page excludes #VALUE! #NUM!
Provenance

The second half of the same Remark: pr <= 0 is a #NUM!.

Mismatch
=YIELDMAT(A2,A3,A4,A5,A6,5) A basis of 5, which is outside the documented table #VALUE! #NUM!
Provenance

The Remarks publish: "If basis < 0 or if basis > 4, YIELDMAT returns the #NUM! error value."

Mismatch
=YIELDMAT(A2,A3,"not a date",A5,A6,A7) A non-date issue argument #VALUE! #VALUE!
Provenance

The Remarks publish: "If settlement, maturity, or issue is not a valid date, YIELDMAT returns the #VALUE! error value." The issue date is asserted rather than the settlement date because issue is the argument this function has and its YIELD/YIELDDISC siblings do not.

Matched

Docs & syntax

Where YIELDMAT behaves differently