TBILLYIELD
Quirk foundCategory: Financial · Last tested 2026-09-01
Real compatibility results for the TBILLYIELD 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 TBILLYIELD’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 TBILLYIELD working in LibreOffice?
TBILLYIELD 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
-
=TBILLYIELD(A2,A3,0) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The Remarks publish: "If pr <= 0, TBILLYIELD returns the #NUM! error value." The formula divides by pr, so zero would be a division by zero as well as a documented exclusion.; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=TBILLYIELD(A2,A2,A4) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
A DELIBERATE DIFFERENCE BETWEEN THE THREE TBILL PAGES, recorded because it is testable. TBILLYIELD's Remark publishes "If settlement >= maturity, or if maturity is more than one year after settlement, TBILLYIELD returns the #NUM! error value" -- with a GREATER-THAN-OR-EQUAL -- while TBILLEQ and TBILLPRICE both publish "If settlement > maturity". Equal dates are therefore documented as an error here and not documented as one on the other two pages; the arithmetic agrees, since DSM = 0 would divide by zero. Only TBILLYIELD's file asserts this case, because only TBILLYIELD's page states it.; MISMATCH vs expected: expected '#NUM!', got '#VALUE!'
-
=TBILLYIELD(A2,A2+400,A4) on
LibreOffice Calc returned
#VALUE!, but the documented/expected
result is #NUM!.
Provenance
The second half of the same Remark.; 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(TBILLYIELD(A2,A3,A4),4) | Microsoft's documented worked example, at the four decimals its description publishes | 0.0914 | 0.0914ProvenanceMicrosoft publishes =TBILLYIELD(A2,A3,A4) with the description "The yield for the Treasury bill using the terms in A2, A3, and A4 (0.0914, or 9.14%)" and a Result cell formatted as "9.14%". Settlement 2008-03-31, maturity 2008-06-01, price $98.45 per $100 face value. DERIVATION (the page's formula is an image, awftbyd.gif, with the same DSM legend): (100 - pr)/pr * (360/DSM) with the ACTUAL day count 62 gives 0.09141696292534281361097, i.e. 0.0914 at the published precision. Microsoft's page was read live on 2026-08-31 at https://support.microsoft.com/en-us/excel/functions/tbillyield-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(TBILLYIELD(A2,A3,A4),10) | The same example carried to ten decimals | 0.0914169629 | 0.0914169629ProvenanceAsserted at ten places from the derivation: 0.0914169629. Four published decimals cannot separate the actual day count from the 30/360 one here either (61 days would give 0.0929), though in this case the difference is larger than it is for TBILLEQ. |
Matched |
| =TBILLYIELD(A2,A3,0) | A price of zero, which the page excludes | #NUM! | #NUM!ProvenanceThe Remarks publish: "If pr <= 0, TBILLYIELD returns the #NUM! error value." The formula divides by pr, so zero would be a division by zero as well as a documented exclusion. |
Matched |
| =TBILLYIELD(A2,A2,A4) | Settlement equal to maturity, which THIS page excludes with >= where its two siblings use > | #NUM! | #NUM!ProvenanceA DELIBERATE DIFFERENCE BETWEEN THE THREE TBILL PAGES, recorded because it is testable. TBILLYIELD's Remark publishes "If settlement >= maturity, or if maturity is more than one year after settlement, TBILLYIELD returns the #NUM! error value" -- with a GREATER-THAN-OR-EQUAL -- while TBILLEQ and TBILLPRICE both publish "If settlement > maturity". Equal dates are therefore documented as an error here and not documented as one on the other two pages; the arithmetic agrees, since DSM = 0 would divide by zero. Only TBILLYIELD's file asserts this case, because only TBILLYIELD's page states it. |
Matched |
| =TBILLYIELD(A2,A2+400,A4) | A maturity more than a year after settlement, which the page excludes | #NUM! | #NUM!ProvenanceThe second half of the same Remark. |
Matched |
| =TBILLYIELD("not a date",A3,A4) | A non-date settlement argument | #VALUE! | #VALUE!ProvenanceThe Remarks publish: "If settlement or maturity is not a valid date, TBILLYIELD returns the #VALUE! 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(TBILLYIELD(A2,A3,A4),4) | Microsoft's documented worked example, at the four decimals its description publishes | 0.0914 | 0.0914ProvenanceMicrosoft publishes =TBILLYIELD(A2,A3,A4) with the description "The yield for the Treasury bill using the terms in A2, A3, and A4 (0.0914, or 9.14%)" and a Result cell formatted as "9.14%". Settlement 2008-03-31, maturity 2008-06-01, price $98.45 per $100 face value. DERIVATION (the page's formula is an image, awftbyd.gif, with the same DSM legend): (100 - pr)/pr * (360/DSM) with the ACTUAL day count 62 gives 0.09141696292534281361097, i.e. 0.0914 at the published precision. Microsoft's page was read live on 2026-08-31 at https://support.microsoft.com/en-us/excel/functions/tbillyield-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(TBILLYIELD(A2,A3,A4),10) | The same example carried to ten decimals | 0.0914169629 | 0.0914169629ProvenanceAsserted at ten places from the derivation: 0.0914169629. Four published decimals cannot separate the actual day count from the 30/360 one here either (61 days would give 0.0929), though in this case the difference is larger than it is for TBILLEQ. |
Matched |
| =TBILLYIELD(A2,A3,0) | A price of zero, which the page excludes | #NUM! | #NUM!ProvenanceThe Remarks publish: "If pr <= 0, TBILLYIELD returns the #NUM! error value." The formula divides by pr, so zero would be a division by zero as well as a documented exclusion. |
Matched |
| =TBILLYIELD(A2,A2,A4) | Settlement equal to maturity, which THIS page excludes with >= where its two siblings use > | #NUM! | #NUM!ProvenanceA DELIBERATE DIFFERENCE BETWEEN THE THREE TBILL PAGES, recorded because it is testable. TBILLYIELD's Remark publishes "If settlement >= maturity, or if maturity is more than one year after settlement, TBILLYIELD returns the #NUM! error value" -- with a GREATER-THAN-OR-EQUAL -- while TBILLEQ and TBILLPRICE both publish "If settlement > maturity". Equal dates are therefore documented as an error here and not documented as one on the other two pages; the arithmetic agrees, since DSM = 0 would divide by zero. Only TBILLYIELD's file asserts this case, because only TBILLYIELD's page states it. |
Matched |
| =TBILLYIELD(A2,A2+400,A4) | A maturity more than a year after settlement, which the page excludes | #NUM! | #NUM!ProvenanceThe second half of the same Remark. |
Matched |
| =TBILLYIELD("not a date",A3,A4) | A non-date settlement argument | #VALUE! | #VALUE!ProvenanceThe Remarks publish: "If settlement or maturity is not a valid date, TBILLYIELD returns the #VALUE! error value." |
Matched |
LibreOffice Calc 25.8.7.3 (tested 2026-08-31)
| Formula | Description | Result | Expected | Verdict |
|---|---|---|---|---|
| =ROUND(TBILLYIELD(A2,A3,A4),4) | Microsoft's documented worked example, at the four decimals its description publishes | 0.0914 | 0.0914ProvenanceMicrosoft publishes =TBILLYIELD(A2,A3,A4) with the description "The yield for the Treasury bill using the terms in A2, A3, and A4 (0.0914, or 9.14%)" and a Result cell formatted as "9.14%". Settlement 2008-03-31, maturity 2008-06-01, price $98.45 per $100 face value. DERIVATION (the page's formula is an image, awftbyd.gif, with the same DSM legend): (100 - pr)/pr * (360/DSM) with the ACTUAL day count 62 gives 0.09141696292534281361097, i.e. 0.0914 at the published precision. Microsoft's page was read live on 2026-08-31 at https://support.microsoft.com/en-us/excel/functions/tbillyield-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(TBILLYIELD(A2,A3,A4),10) | The same example carried to ten decimals | 0.0914169629 | 0.0914169629ProvenanceAsserted at ten places from the derivation: 0.0914169629. Four published decimals cannot separate the actual day count from the 30/360 one here either (61 days would give 0.0929), though in this case the difference is larger than it is for TBILLEQ. |
Matched |
| =TBILLYIELD(A2,A3,0) | A price of zero, which the page excludes | #VALUE! | #NUM!ProvenanceThe Remarks publish: "If pr <= 0, TBILLYIELD returns the #NUM! error value." The formula divides by pr, so zero would be a division by zero as well as a documented exclusion. |
Mismatch |
| =TBILLYIELD(A2,A2,A4) | Settlement equal to maturity, which THIS page excludes with >= where its two siblings use > | #VALUE! | #NUM!ProvenanceA DELIBERATE DIFFERENCE BETWEEN THE THREE TBILL PAGES, recorded because it is testable. TBILLYIELD's Remark publishes "If settlement >= maturity, or if maturity is more than one year after settlement, TBILLYIELD returns the #NUM! error value" -- with a GREATER-THAN-OR-EQUAL -- while TBILLEQ and TBILLPRICE both publish "If settlement > maturity". Equal dates are therefore documented as an error here and not documented as one on the other two pages; the arithmetic agrees, since DSM = 0 would divide by zero. Only TBILLYIELD's file asserts this case, because only TBILLYIELD's page states it. |
Mismatch |
| =TBILLYIELD(A2,A2+400,A4) | A maturity more than a year after settlement, which the page excludes | #VALUE! | #NUM!ProvenanceThe second half of the same Remark. |
Mismatch |
| =TBILLYIELD("not a date",A3,A4) | A non-date settlement argument | #VALUE! | #VALUE!ProvenanceThe Remarks publish: "If settlement or maturity is not a valid date, TBILLYIELD returns the #VALUE! error value." |
Matched |
Docs & syntax
- Excel (desktop): official documentation
- Google Sheets: official documentation
- LibreOffice Calc: official documentation
Where TBILLYIELD 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.