YIELDMAT
Quirk foundCategory: 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
| Engine | Documented | Live-tested | Verdict |
|---|---|---|---|
| Excel (desktop) | Yes | No — documented only | n/a |
| Excel for the web | — | Yes (recalc, 2026-09-01) | Supported, behaves as documented |
| Google Sheets | Yes | Yes (Drive import, 2026-08-31) | Supported, behaves as documented |
| LibreOffice Calc | Yes | 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 version | Verdict | Tested |
|---|---|---|
| 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
-
=YIELDMAT(A3,A2,A4,A5,A6,A7) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If settlement >= maturity, YIELDMAT returns the #NUM! error value."; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=YIELDMAT(A2,A3,A4,-0.01,A6,A7) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If rate < 0 or if pr <= 0, YIELDMAT returns the #NUM! error value."; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=YIELDMAT(A2,A3,A4,A5,0,A7) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The second half of the same Remark: pr <= 0 is a #NUM!.; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=YIELDMAT(A2,A3,A4,A5,A6,5) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If basis < 0 or if basis > 4, YIELDMAT returns the #NUM! error value."; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
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.
| Formula | Description | Result | Expected | Verdict |
|---|---|---|---|---|
| =ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),6) | Microsoft's documented worked example, at the six decimals its description publishes | 0.060954 | 0.060954ProvenanceMicrosoft 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.0609543337ProvenanceAsserted 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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.
| Formula | Description | Result | Expected | Verdict |
|---|---|---|---|---|
| =ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),6) | Microsoft's documented worked example, at the six decimals its description publishes | 0.060954 | 0.060954ProvenanceMicrosoft 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.0609543337ProvenanceAsserted 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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)
| Formula | Description | Result | Expected | Verdict |
|---|---|---|---|---|
| =ROUND(YIELDMAT(A2,A3,A4,A5,A6,A7),6) | Microsoft's documented worked example, at the six decimals its description publishes | 0.060954 | 0.060954ProvenanceMicrosoft 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.0609543337ProvenanceAsserted 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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!ProvenanceThe 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
- Excel (desktop): official documentation
- Google Sheets: official documentation
- LibreOffice Calc: official documentation
Where YIELDMAT behaves differently
- Bond and treasury functions after a migration: what actually breaks
Executed across 26 fixed-income functions and 161 cases: ODDFPRICE and ODDFYIELD are literal stubs in LibreOffice, TBILLPRICE prices a two-year bill, INTRATE's default basis loses a day, and MDURATION is wrong on actual/actual. 83 of 84 documented #NUM! cases arrive as #VALUE!. Google Sheets matched 127 of 161. - Every error code LibreOffice reports as #VALUE!
Across our 2,334-case executed corpus, 272 cases in 135 functions return #VALUE! in LibreOffice Calc 25.8.7.3 where Microsoft documents #NUM! (244), #N/A (15), #DIV/0! (10) or #REF! (3). Google Sheets returns the documented code on 239 of the 249 it has a function for. Identical in all four LibreOffice builds tested.