YIELDDISC
Quirk foundCategory: Financial · Last tested 2026-09-01
Real compatibility results for the YIELDDISC 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 YIELDDISC’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 YIELDDISC working in LibreOffice?
YIELDDISC 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.
_xlfn., _xlfn._xlws.,
_xlpm.) — nor does the .xlsx export preserve full float
precision or a blank result. Where the disagreement is explained by that
round trip we report it as inconclusive rather than as a Sheets behavior.
Google documents this function, so the result is not evidence of
missing support. See the methodology page
for the full caveat and the planned re-run with plain function names.
Discovered quirks
-
=YIELDDISC(A3,A2,A4,A5,A6) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If settlement >= maturity, YIELDDISC returns the #NUM! error value."; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=YIELDDISC(A2,A3,0,A5,A6) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If pr <= 0 or if redemption <= 0, YIELDDISC returns the #NUM! error value."; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=YIELDDISC(A2,A3,A4,A5,5) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If basis < 0 or if basis > 4, YIELDDISC 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(YIELDDISC(A2,A3,A4,A5,A6),6) | Microsoft's documented worked example, at the six decimals it publishes | 0.052823 | 0.052823ProvenanceMicrosoft publishes =YIELDDISC(A2,A3,A4,A5,A6) = 0.052823 ("The yield, for the bond with the terms above (0.052823 or 5.28%)"). Settlement 2008-02-16 (serial 39494), maturity 2008-03-01 (serial 39508), price 99.795, redemption 100, basis 2 (Actual/360). DERIVATION -- AND THE PAGE PRINTS NO FORMULA AT ALL: every image in the YIELDDISC article body was enumerated and there are none, so the closed form was taken from the definition of a discounted security's yield, (redemption - pr)/pr * B/DSM, and checked against the published figure. With basis 2 the days-in-year B is 360 and the actual day count from 2008-02-16 to 2008-03-01 is 14, giving 0.205/99.795 * 360/14 = 0.052822571986858774774, i.e. 0.052823 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/yielddisc-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(YIELDDISC(A2,A3,A4,A5,A6),10) | The same example carried to ten decimals | 0.052822572 | 0.052822572ProvenanceAsserted at ten places from the derivation: 0.052822572. Six published decimals cannot see a basis mix-up: basis 3 (Actual/365) would give 0.053556, which IS visible, but basis 0 (30/360) counts 15 days rather than 14 and gives 0.049301, which is also visible -- so this case is really about the arithmetic rather than the day count, and it is the ten-place assertion that makes it sharp. |
Matched |
| =ROUND(YIELDDISC(A2,A3,50,100,2),10) | A price of exactly half redemption, where the yield has a closed form with no derived constant | 25.7142857143 | 25.7142857143ProvenanceAt pr = 50 and redemption = 100 the ratio (redemption-pr)/pr is exactly 1, so the yield is exactly B/DSM = 360/14 = 180/7 = 25.714285714285714..., i.e. 25.7142857143 at ten places. A STRUCTURAL ASSERTION WITH NO DERIVED CONSTANT that isolates the day-count factor completely: it reads the engine's B/DSM off directly, and any basis or day-count error changes it visibly (basis 3 would give 365/14 = 26.0714, basis 0 would give 360/15 = 24). |
Matched |
| =YIELDDISC(A3,A2,A4,A5,A6) | The dates reversed, which the page excludes | #NUM! | #NUM!ProvenanceThe Remarks publish: "If settlement >= maturity, YIELDDISC returns the #NUM! error value." |
Matched |
| =YIELDDISC(A2,A3,0,A5,A6) | A price of zero, which the page excludes | #NUM! | #NUM!ProvenanceThe Remarks publish: "If pr <= 0 or if redemption <= 0, YIELDDISC returns the #NUM! error value." |
Matched |
| =YIELDDISC(A2,A3,A4,A5,5) | A basis of 5, which is outside the documented table | #NUM! | #NUM!ProvenanceThe Remarks publish: "If basis < 0 or if basis > 4, YIELDDISC returns the #NUM! error value." |
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(YIELDDISC(A2,A3,A4,A5,A6),6) | Microsoft's documented worked example, at the six decimals it publishes | 0.052823 | 0.052823ProvenanceMicrosoft publishes =YIELDDISC(A2,A3,A4,A5,A6) = 0.052823 ("The yield, for the bond with the terms above (0.052823 or 5.28%)"). Settlement 2008-02-16 (serial 39494), maturity 2008-03-01 (serial 39508), price 99.795, redemption 100, basis 2 (Actual/360). DERIVATION -- AND THE PAGE PRINTS NO FORMULA AT ALL: every image in the YIELDDISC article body was enumerated and there are none, so the closed form was taken from the definition of a discounted security's yield, (redemption - pr)/pr * B/DSM, and checked against the published figure. With basis 2 the days-in-year B is 360 and the actual day count from 2008-02-16 to 2008-03-01 is 14, giving 0.205/99.795 * 360/14 = 0.052822571986858774774, i.e. 0.052823 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/yielddisc-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(YIELDDISC(A2,A3,A4,A5,A6),10) | The same example carried to ten decimals | 0.052822572 | 0.052822572ProvenanceAsserted at ten places from the derivation: 0.052822572. Six published decimals cannot see a basis mix-up: basis 3 (Actual/365) would give 0.053556, which IS visible, but basis 0 (30/360) counts 15 days rather than 14 and gives 0.049301, which is also visible -- so this case is really about the arithmetic rather than the day count, and it is the ten-place assertion that makes it sharp. |
Matched |
| =ROUND(YIELDDISC(A2,A3,50,100,2),10) | A price of exactly half redemption, where the yield has a closed form with no derived constant | 25.71428571 | 25.7142857143ProvenanceAt pr = 50 and redemption = 100 the ratio (redemption-pr)/pr is exactly 1, so the yield is exactly B/DSM = 360/14 = 180/7 = 25.714285714285714..., i.e. 25.7142857143 at ten places. A STRUCTURAL ASSERTION WITH NO DERIVED CONSTANT that isolates the day-count factor completely: it reads the engine's B/DSM off directly, and any basis or day-count error changes it visibly (basis 3 would give 365/14 = 26.0714, basis 0 would give 360/15 = 24). |
Inconclusive |
| =YIELDDISC(A3,A2,A4,A5,A6) | The dates reversed, which the page excludes | #NUM! | #NUM!ProvenanceThe Remarks publish: "If settlement >= maturity, YIELDDISC returns the #NUM! error value." |
Matched |
| =YIELDDISC(A2,A3,0,A5,A6) | A price of zero, which the page excludes | #NUM! | #NUM!ProvenanceThe Remarks publish: "If pr <= 0 or if redemption <= 0, YIELDDISC returns the #NUM! error value." |
Matched |
| =YIELDDISC(A2,A3,A4,A5,5) | A basis of 5, which is outside the documented table | #NUM! | #NUM!ProvenanceThe Remarks publish: "If basis < 0 or if basis > 4, YIELDDISC returns the #NUM! error value." |
Matched |
LibreOffice Calc 25.8.7.3 (tested 2026-08-31)
| Formula | Description | Result | Expected | Verdict |
|---|---|---|---|---|
| =ROUND(YIELDDISC(A2,A3,A4,A5,A6),6) | Microsoft's documented worked example, at the six decimals it publishes | 0.052823 | 0.052823ProvenanceMicrosoft publishes =YIELDDISC(A2,A3,A4,A5,A6) = 0.052823 ("The yield, for the bond with the terms above (0.052823 or 5.28%)"). Settlement 2008-02-16 (serial 39494), maturity 2008-03-01 (serial 39508), price 99.795, redemption 100, basis 2 (Actual/360). DERIVATION -- AND THE PAGE PRINTS NO FORMULA AT ALL: every image in the YIELDDISC article body was enumerated and there are none, so the closed form was taken from the definition of a discounted security's yield, (redemption - pr)/pr * B/DSM, and checked against the published figure. With basis 2 the days-in-year B is 360 and the actual day count from 2008-02-16 to 2008-03-01 is 14, giving 0.205/99.795 * 360/14 = 0.052822571986858774774, i.e. 0.052823 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/yielddisc-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(YIELDDISC(A2,A3,A4,A5,A6),10) | The same example carried to ten decimals | 0.052822572 | 0.052822572ProvenanceAsserted at ten places from the derivation: 0.052822572. Six published decimals cannot see a basis mix-up: basis 3 (Actual/365) would give 0.053556, which IS visible, but basis 0 (30/360) counts 15 days rather than 14 and gives 0.049301, which is also visible -- so this case is really about the arithmetic rather than the day count, and it is the ten-place assertion that makes it sharp. |
Matched |
| =ROUND(YIELDDISC(A2,A3,50,100,2),10) | A price of exactly half redemption, where the yield has a closed form with no derived constant | 25.7142857143 | 25.7142857143ProvenanceAt pr = 50 and redemption = 100 the ratio (redemption-pr)/pr is exactly 1, so the yield is exactly B/DSM = 360/14 = 180/7 = 25.714285714285714..., i.e. 25.7142857143 at ten places. A STRUCTURAL ASSERTION WITH NO DERIVED CONSTANT that isolates the day-count factor completely: it reads the engine's B/DSM off directly, and any basis or day-count error changes it visibly (basis 3 would give 365/14 = 26.0714, basis 0 would give 360/15 = 24). |
Matched |
| =YIELDDISC(A3,A2,A4,A5,A6) | The dates reversed, which the page excludes | #VALUE! | #NUM!ProvenanceThe Remarks publish: "If settlement >= maturity, YIELDDISC returns the #NUM! error value." |
Mismatch |
| =YIELDDISC(A2,A3,0,A5,A6) | A price of zero, which the page excludes | #VALUE! | #NUM!ProvenanceThe Remarks publish: "If pr <= 0 or if redemption <= 0, YIELDDISC returns the #NUM! error value." |
Mismatch |
| =YIELDDISC(A2,A3,A4,A5,5) | A basis of 5, which is outside the documented table | #VALUE! | #NUM!ProvenanceThe Remarks publish: "If basis < 0 or if basis > 4, YIELDDISC returns the #NUM! error value." |
Mismatch |
Docs & syntax
- Excel (desktop): official documentation
- Google Sheets: official documentation
- LibreOffice Calc: official documentation
Where YIELDDISC 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.