{ "category": "Date and time functions", "display_name": "WORKDAY.INTL", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.WORKDAY.INTL", "implementation_state": { "answer_bank": { "excel_builds": [ "20430" ], "larger_numeric": 0, "last_bit": 0, "matched": 6000, "other_mismatch": 0, "refused": 0, "rows": 6000, "unread": 0, "worst_ulp": 0 }, "detail": "Recorded: 6,000 in the answer bank and 22 workbook cells.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "matches", "state_label": "Matches every recorded Excel answer", "summary": "Matches all 6,022 recorded answers", "workbook_corpus": { "cells": 22, "matched": 22 } }, "implementations": [ { "commit": "9e1884369a678158dd82d3d74188daf986995e87", "flavour": "excel-compatibility-candidate", "language": "Rust", "name": "CalcFunc", "own_code": [ "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/dates.rs#L322-L324" ], "repository": "https://github.com/DnaCalc/DnaCalc", "shared_code": [ "catalogue/dates::environment", "catalogue/dates::system", "catalogue/dates::to_1900", "catalogue/dates::from_1900", "catalogue/dates::present_num", "catalogue/dates::serial_out", "catalogue/dates::weekend", "catalogue/dates::holidays", "catalogue/dates::workday", "ported/date_kernels::days", "ported/date_kernels::weekday_sunday_one_based", "ported/date_kernels::WeekendMask::saturday_sunday", "ported/date_kernels::WeekendMask::from_number", "ported/date_kernels::WeekendMask::from_mask_text", "ported/date_kernels::WeekendMask::is_all_days", "ported/date_kernels::WeekendMask::contains_serial", "ported/date_kernels::serial_from_number", "ported/date_kernels::is_business_day", "ported/date_kernels::workday" ], "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/dates.rs#L322-L324", "state": "matches", "suite": null, "summary": "Matches all 6,022 recorded answers" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.WORKDAY.INTL.json", "name": "WORKDAY.INTL", "notes": [ { "basis": "19 NETWORKDAYS.INTL and 20 WORKDAY.INTL readings with errors held in cells, and the logical weekend readings of the argument sheets.", "documentation": null, "evidence": [ { "commit": "287c5b9a3bec81ea96f12ad485f18a0d4b729063", "locator": "delivered_scalar_readings_follow_the_application_route", "note": "recorded answers pinned", "path": "apps/dna-onecalc/tests/acceptance.rs", "repository": "DnaCalc" }, { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": null, "note": "19 recorded readings", "path": "crates/calc-func/tests/captures/fn4_questions/NETWORKDAYS.INTL.reading.json", "repository": "DnaCalc" }, { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": null, "note": "20 recorded readings", "path": "crates/calc-func/tests/captures/fn4_questions/WORKDAY.INTL.reading.json", "repository": "DnaCalc" } ], "functions": [ "FUNC.NETWORKDAYS.INTL", "FUNC.WORKDAY.INTL" ], "inferred": null, "kind": "quirk", "note_id": "FN-NETWORKDAYS.INTL-001", "open": [], "recorded_on": "2026-11-04", "repros": [ { "call": "NETWORKDAYS.INTL(A1, 5, 0)", "correct": null, "excel": { "bits": null, "display": "#NUM!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "start_date", "value": { "bits": null, "display": "#REF!", "kind": "error" } }, { "name": "end_date", "value": { "bits": "0x4014000000000000", "display": "5", "kind": "number" } }, { "name": "weekend", "value": { "bits": "0x0000000000000000", "display": "0", "kind": "number" } } ], "recorded_in": "Excel 16.0.20527.20088, Windows, bitness and CPU not recorded in this reading file", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "fn7-NETWORKDAYS.INTL-weekend-first-order-2", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/NETWORKDAYS.INTL.reading.json", "repository": "DnaCalc" } }, { "call": "WORKDAY.INTL(A1, 5, 0)", "correct": null, "excel": { "bits": null, "display": "#REF!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "start_date", "value": { "bits": null, "display": "#REF!", "kind": "error" } }, { "name": "days", "value": { "bits": "0x4014000000000000", "display": "5", "kind": "number" } }, { "name": "weekend", "value": { "bits": "0x0000000000000000", "display": "0", "kind": "number" } } ], "recorded_in": "Excel 16.0.20527.20088, Windows, bitness and CPU not recorded in this reading file", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "fn7-WORKDAY.INTL-weekend-first-order-2", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/WORKDAY.INTL.reading.json", "repository": "DnaCalc" } }, { "call": "NETWORKDAYS.INTL(2, 5, A3)", "correct": null, "excel": { "bits": null, "display": "#VALUE!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "start_date", "value": { "bits": "0x4000000000000000", "display": "2", "kind": "number" } }, { "name": "end_date", "value": { "bits": "0x4014000000000000", "display": "5", "kind": "number" } }, { "name": "weekend", "value": { "bits": null, "display": "#REF!", "kind": "error" } } ], "recorded_in": "Excel 16.0.20527.20088, Windows, bitness and CPU not recorded in this reading file", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "fn7-NETWORKDAYS.INTL-admission-order-6", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/NETWORKDAYS.INTL.reading.json", "repository": "DnaCalc" } }, { "call": "WORKDAY.INTL(2, 5, A3)", "correct": null, "excel": { "bits": null, "display": "#NUM!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "start_date", "value": { "bits": "0x4000000000000000", "display": "2", "kind": "number" } }, { "name": "days", "value": { "bits": "0x4014000000000000", "display": "5", "kind": "number" } }, { "name": "weekend", "value": { "bits": null, "display": "#REF!", "kind": "error" } } ], "recorded_in": "Excel 16.0.20527.20088, Windows, bitness and CPU not recorded in this reading file", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "fn7-WORKDAY.INTL-admission-order-6", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/WORKDAY.INTL.reading.json", "repository": "DnaCalc" } }, { "call": "=NETWORKDAYS.INTL(2,5,TRUE)", "correct": null, "excel": { "bits": "0x4010000000000000", "display": "4", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa043, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=NETWORKDAYS.INTL(2,5,FALSE)", "correct": null, "excel": { "bits": null, "display": "#NUM!", "kind": "error" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa044, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=WORKDAY.INTL(2,2,TRUE)", "correct": null, "excel": { "bits": "0x4010000000000000", "display": "4", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa065, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=WORKDAY.INTL(2,2,FALSE)", "correct": null, "excel": { "bits": null, "display": "#NUM!", "kind": "error" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa066, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } } ], "schema": "efh.function-note/v1", "statement": "The two functions read their arguments in different orders. NETWORKDAYS.INTL decodes weekend first: with #REF! in the cell for start_date and weekend 0, the answer is #NUM!, from the invalid weekend. WORKDAY.INTL reads start_date first and gives #REF! for the same arguments. An error held in the weekend cell is also treated differently: with start 2 and second argument 5, NETWORKDAYS.INTL gives #VALUE! and WORKDAY.INTL gives #NUM!. Neither returns the error itself. A logical weekend is read as a number: NETWORKDAYS.INTL(2,5,TRUE) is 4, as with weekend 1, and FALSE is #NUM!, as with weekend 0. WORKDAY.INTL does the same.", "status": "measured", "title": "NETWORKDAYS.INTL checks weekend before the dates, WORKDAY.INTL after them" }, { "basis": "8 recorded readings with an empty B1, one per function, each paired with a reading with TRUE in B1.", "documentation": null, "evidence": [ { "commit": "c4c5dde7e2dcf735d2849835fc49769e2ab67ba7", "locator": "delivered_fn4_blank_date_references_read_serial_zero", "note": "recorded answers pinned", "path": "apps/dna-onecalc/tests/acceptance.rs", "repository": "DnaCalc" }, { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheets qa031 and qa032, and the like pairs of each function", "note": "recorded readings", "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } ], "functions": [ "FUNC.NETWORKDAYS", "FUNC.NETWORKDAYS.INTL", "FUNC.TBILLEQ", "FUNC.TBILLPRICE", "FUNC.TBILLYIELD", "FUNC.WORKDAY", "FUNC.WORKDAY.INTL", "FUNC.YEARFRAC" ], "inferred": null, "kind": "quirk", "note_id": "FN-WORKDAY-001", "open": [ "An argument left empty in the call was not read here for YEARFRAC and the T-bill functions." ], "recorded_on": "2026-11-04", "repros": [ { "call": "=NETWORKDAYS(B1,5)", "correct": null, "excel": { "bits": "0x4010000000000000", "display": "4", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa032, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=NETWORKDAYS(B1,5)", "correct": null, "excel": { "bits": null, "display": "#VALUE!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "TRUE", "kind": "logical" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa031, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=WORKDAY(B1,2)", "correct": null, "excel": { "bits": "0x4008000000000000", "display": "3", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa054, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=WORKDAY(B1,2)", "correct": null, "excel": { "bits": null, "display": "#VALUE!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "TRUE", "kind": "logical" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa053, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=NETWORKDAYS.INTL(B1,5,1)", "correct": null, "excel": { "bits": "0x4010000000000000", "display": "4", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa040, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=WORKDAY.INTL(B1,2,1)", "correct": null, "excel": { "bits": "0x4008000000000000", "display": "3", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa062, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=YEARFRAC(B1,5,0)", "correct": null, "excel": { "bits": "0x3f8c71c71c71c71c", "display": "0.013888888888888888", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa072, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } }, { "call": "=TBILLEQ(B1,5,0.1)", "correct": null, "excel": { "bits": "0x3fb9fddd1b6a757f", "display": "0.10152990264255911", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "source": { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheet qa082, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-arguments.capture.json", "repository": "DnaCalc" } } ], "schema": "efh.function-note/v1", "statement": "A reference to an empty cell as the first date of these functions reads as serial 0 and gives a normal answer: NETWORKDAYS(B1,5) is 4 and WORKDAY(B1,2) is 3. YEARFRAC(B1,5,0) is 5/360. TRUE in the same cell gives #VALUE!, as a direct TRUE does, so a blank is not treated as the logical FALSE either.", "status": "measured", "title": "An empty cell as a first date is serial 0, but a logical in that cell is #VALUE!" } ], "schema": "efh.function-reference/v1", "section_order": [ "what-it-does", "try-it", "quirks", "how-to-implement", "version-differences", "alternatives" ], "sections": { "alternatives": "\n### Relationships\n\n\n- **[WORKDAY](FUNC.WORKDAY.md)** — the un-generalized original. `WORKDAY(a,n,h)` should equal\n `WORKDAY.INTL(a,n,1,h)`; unverified here.\n- **[NETWORKDAYS.INTL](FUNC.NETWORKDAYS.INTL.md)** — the inverse operation, sharing this exact\n `weekend` argument. Their weekend interpretations must agree or the family is incoherent; that\n they do is assumed and unchecked.\n- **[NETWORKDAYS](FUNC.NETWORKDAYS.md)** — the un-generalized inverse.\n- **[EDATE](FUNC.EDATE.md)** — month offsetting, the other \"move a date by whole units\" function,\n with the same documented truncation rule for its offset argument.\n\n\n", "how-to-implement": "\n### Notes for implementers\n\n\n1. **Normalize `weekend` to a seven-bit mask once `start_date` has been read**, the order Excel\n uses (FN-NETWORKDAYS.INTL-001), from either shape, and reject\n the all-ones mask here even if the counting sibling tolerates it — an offset over a week with no\n working days does not terminate.\n2. **Use whole-week arithmetic.** With `w = popcount(¬mask)` working days per week, `days` decomposes\n into `⌊days/w⌋` whole weeks plus a remainder resolved against the start day's position in the\n week. Stepping day by day is correct and unusably slow across the serial range.\n3. **Iterate the holiday exclusion to a fixed point.** Skipping a holiday moves the target, which\n may itself be a holiday; a single pass is wrong for consecutive holidays.\n4. **Keep the `days = 0` convention identical to `WORKDAY`'s**, whatever it turns out to be.\n5. **Do not share the error path with `WORKDAY`** until the documented divergence above is resolved\n by observation.\n\n\n", "quirks": "\n### Result and edge cases\n\n\nReturns a `Number`: a whole date serial.\n\n- **`days = 0`** exposes the counting convention, exactly as on [WORKDAY](FUNC.WORKDAY.md), and the\n page is equally silent about it. Whether a start date falling on a weekend is returned unchanged\n or snapped is the diagnostic case.\n- **A six-day weekend** leaves one working day per week, which is legal and makes offsets large in\n calendar terms — a good stress case for any closed-form implementation.\n- **Holidays that fall on weekend days** should contribute nothing; undocumented.\n- **Consecutive holidays** require the exclusion pass to iterate; see the implementer notes.\n- **Blank cells in a `holidays` range** raise the Empty-versus-Missing question from\n [the value universe](../model/01-value-universe.md); serial 0 is a representable date.\n\n\n\n### Errors\n\n\nDocumented on the Microsoft page, and this is the fullest error table in the family:\n\n- `#NUM!` when \"start_date is out of range for the current date base value\".\n- `#NUM!` when \"any date in holidays is out of range for the current date base value\".\n- `#NUM!` when \"start_date plus day-offset yields an invalid date\".\n- `#VALUE!` when \"a weekend string is of invalid length or contains invalid characters\".\n\nTwo observations the Handbook records rather than smooths over:\n\n1. **The holidays condition is documented here and not on [WORKDAY](FUNC.WORKDAY.md)'s page**,\n which mentions only \"any argument is not a valid date\" (`#VALUE!`). Two functions performing the\n same holiday exclusion, documented with different error values for an out-of-range holiday.\n2. **Only the string form of `weekend` has a documented invalidity condition.** What an\n out-of-table numeric code does is not stated. Code 0 gives `#NUM!` (FN-NETWORKDAYS.INTL-001);\n 8, 10 and 18 are not asserted here.\n\n\n", "sources": "\n- Microsoft 365 support, **WORKDAY.INTL function** —\n .\n Source of the weekend number table, the weekend string rules including the \"at least one workday\n required\" statement, and all four documented error conditions.\n- Microsoft 365 support, **NETWORKDAYS.INTL function** —\n .\n- Microsoft 365 support, **WORKDAY function** —\n .\n Source of the `days` truncation rule and of the contrasting error conditions.\n- Handbook call-model chapter [01 value universe](../model/01-value-universe.md).\n- `data/functions/FUNC.WORKDAY.INTL.json`, `data/presence/FUNC.WORKDAY.INTL.json`,\n `data/battery/FUNC.WORKDAY.INTL.json`.\n\n", "version-differences": "The recorded environments below distinguish a reading from a same-input comparison. Counts describe captured inputs in each environment; overlapping captures and comparisons are not totals of unique worksheet calls.\n\n| Excel 16.0 build | Platform and CPU | Captured inputs |\n|---|---|---:|\n| 20430 | Windows, 64-bit, AMD Ryzen 7 4800H with Radeon Graphics | 4,800 |\n\nThe record contains no same-input comparison between these environments. Reading different inputs on different builds does not establish either a version change or cross-build agreement.\n\n[Recorded environments and comparison details](https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.WORKDAY.INTL.json).", "what-it-does": "\n`WORKDAY.INTL` returns the date lying a given number of working days before or after a start date,\nwhere **which days are weekend is an argument** rather than a fixed Saturday and Sunday. It is to\n[WORKDAY](FUNC.WORKDAY.md) what [NETWORKDAYS.INTL](FUNC.NETWORKDAYS.INTL.md) is to\n[NETWORKDAYS](FUNC.NETWORKDAYS.md), and it shares the `.INTL` weekend argument with the former\nexactly.\n\nThe operation is unchanged from `WORKDAY`: step away from `start_date` in the direction of `days`,\nconsuming one unit of the count for each working day stepped onto, and return where you land. Only\nthe definition of \"working day\" is now parameterized.\n\n\n\n### Arguments\n\n\n`WORKDAY.INTL(start_date, days, [weekend], [holidays])` — two required and two optional.\n\n**start_date** — the date to offset from.\n\n**days** — the number of working days to move; positive forward, negative backward. `WORKDAY`'s\npage documents that a non-integer `days` is truncated, and the same rule is expected here.\n\n**weekend** — optional; the same two-shaped argument documented for `NETWORKDAYS.INTL`.\n\n*As a number:*\n\n| Number | Weekend days |\n|---|---|\n| 1 (default) | Saturday, Sunday |\n| 2 | Sunday, Monday |\n| 3 | Monday, Tuesday |\n| 4 | Tuesday, Wednesday |\n| 5 | Wednesday, Thursday |\n| 6 | Thursday, Friday |\n| 7 | Friday, Saturday |\n| 11 | Sunday only |\n| 12 | Monday only |\n| 13 | Tuesday only |\n| 14 | Wednesday only |\n| 15 | Thursday only |\n| 16 | Friday only |\n| 17 | Saturday only |\n\nCodes 1–7 are consecutive pairs starting one day later each time from Saturday; codes 11–17 are\nsingle days running Sunday through Saturday. The two blocks do not share an origin, and neither\naligns with [WEEKDAY](FUNC.WEEKDAY.md)'s numbering.\n\n*As a string:* seven characters, one per weekday **starting with Monday**, `\"1\"` for a non-workday\nand `\"0\"` for a workday; only those two characters are permitted. Microsoft's `WORKDAY.INTL` page\nadds a rule its sibling's page does not state in the same words: **`\"1111111\"` is invalid**, because\nat least one workday is required. That prohibition is structurally necessary here in a way it is\nnot for a counting function — a week with no working days makes the offset non-terminating, whereas\na count over such a week is simply zero.\n\n**holidays** — optional range or array of dates to exclude.\n\nThe foot-gun is unchanged from the sibling and worth repeating: an unquoted `0000011` is the\n*number* 11, a valid weekend code meaning \"Sunday only\". It produces a plausible wrong answer, not\nan error.\n\n\n" }, "signature": { "display": "WORKDAY.INTL(start_date, days, [weekend], [holidays])", "parameters": [ { "description": null, "name": "start_date", "optional": false, "repeats": false }, { "description": null, "name": "days", "optional": false, "repeats": false }, { "description": null, "name": "weekend", "optional": true, "repeats": false }, { "description": null, "name": "holidays", "optional": true, "repeats": false } ], "trailing_repeats": false }, "sources": { "metadata": { "admission": { "label": "implemented", "reason": null }, "arity": { "max": 4, "min": 2 }, "category": "Date and time functions", "classification": { "arg_preparation_profile": "ValuesOnlyPreAdapter", "coercion_lift_profile": "Custom", "determinism_class": "Deterministic", "error_collapse_profile": "None", "fec_dependency_profile": "None", "host_interaction_class": "None", "kernel_signature_class": "Custom", "rich_value_usage": "RichBlind", "surface_fec_dependency_profile": "RefOnly", "thread_safety_class": "SafePure", "volatility_class": "NonVolatile" }, "descriptions": { "long": null, "short": "Date a number of working days away, with a chosen weekend and listed holidays", "short_source": "dna-calc-own" }, "docs": { "english_description": "Returns the serial number of the date before or after a specified number of workdays using parameters to indicate which and how many days are weekend days", "microsoft_url": "https://support.microsoft.com/en-us/office/workday-intl-function-a378391c-9ba7-4678-8a39-39611a9bf81d" }, "entry_kind": "built_in_function", "localized_family_names": null, "localized_names": [ { "locale": "ar-SA", "name": "WORKDAY.INTL" }, { "locale": "bg-BG", "name": "WORKDAY.INTL" }, { "locale": "cs-CZ", "name": "WORKDAY.INTL" }, { "locale": "da-DK", "name": "ARBEJDSDAG.INTL" }, { "locale": "de-DE", "name": "WORKDAY.INTL" }, { "locale": "el-GR", "name": "WORKDAY.INTL" }, { "locale": "en-AU", "name": "WORKDAY.INTL" }, { "locale": "en-GB", "name": "WORKDAY.INTL" }, { "locale": "en-US", "name": "WORKDAY.INTL" }, { "locale": "es-ES", "name": "DIA.LAB.INTL" }, { "locale": "et-EE", "name": "WORKDAY.INTL" }, { "locale": "fi-FI", "name": "TYÖPÄIVÄ.KANSVÄL" }, { "locale": "fr-FR", "name": "SERIE.JOUR.OUVRE.INTL*" }, { "locale": "he-IL", "name": "WORKDAY.INTL" }, { "locale": "hr-HR", "name": "WORKDAY.INTL" }, { "locale": "hu-HU", "name": "KALK.MUNKANAP.INTL" }, { "locale": "id-ID", "name": "WORKDAY.INTL" }, { "locale": "it-IT", "name": "WORKDAY.INTL" }, { "locale": "ja-JP", "name": "WORKDAY.INTL" }, { "locale": "ko-KR", "name": "WORKDAY.INTL" }, { "locale": "lt-LT", "name": "WORKDAY.INTL" }, { "locale": "lv-LV", "name": "WORKDAY.INTL" }, { "locale": "nb-NO", "name": "WORKDAY.INTL" }, { "locale": "nl-NL", "name": "WERKDAG.INTL" }, { "locale": "pl-PL", "name": "DZIEŃ.ROBOCZY.NIESTAND" }, { "locale": "pt-BR", "name": "WORKDAY.INTL" }, { "locale": "pt-PT", "name": "DIATRABALHO.INTL" }, { "locale": "ro-RO", "name": "WORKDAY.INTL" }, { "locale": "ru-RU", "name": "РАБДЕНЬ.МЕЖД" }, { "locale": "sk-SK", "name": "WORKDAY.INTL" }, { "locale": "sl-SI", "name": "WORKDAY.INTL" }, { "locale": "sr-Latn-RS", "name": "WORKDAY.INTL" }, { "locale": "sv-SE", "name": "ARBETSDAGAR.INT" }, { "locale": "th-TH", "name": "WORKDAY.INTL" }, { "locale": "tr-TR", "name": "İŞGÜNÜ.ULUSL" }, { "locale": "uk-UA", "name": "WORKDAY.INTL" }, { "locale": "vi-VN", "name": "WORKDAY.INTL" }, { "locale": "zh-CN", "name": "WORKDAY.INTL" }, { "locale": "zh-HK", "name": "WORKDAY.INTL" }, { "locale": "zh-TW", "name": "WORKDAY.INTL" } ], "signature": { "display": "WORKDAY.INTL(start_date, days, [weekend], [holidays])", "parameters": [ { "description": null, "name": "start_date", "optional": false, "repeats": false }, { "description": null, "name": "days", "optional": false, "repeats": false }, { "description": null, "name": "weekend", "optional": true, "repeats": false }, { "description": null, "name": "holidays", "optional": true, "repeats": false } ], "trailing_repeats": false }, "surface_name": "WORKDAY.INTL", "version_marker": null, "xlcall": { "code": "521", "symbol": "xlfWorkday_intl" } }, "microsoft": "https://support.microsoft.com/en-us/office/workday-intl-function-a378391c-9ba7-4678-8a39-39611a9bf81d" }, "try_it": { "formula": "=WORKDAY.INTL(DATE(2026,11,2),5,1)" }, "url": "https://handbook.dnacalc.com/functions/WORKDAY.INTL.html", "variants": [], "versions": [ { "behaviour": "WORKDAY.INTL(A1, 5, 0) returned #REF!. WORKDAY.INTL(2, 5, A3) returned #NUM!. Inputs were supplied through cells using Value2. These are controls from this environment, not a same-input comparison with another build.", "excel_build": "16.0.20527.20088", "observations": [ { "call": "WORKDAY.INTL(A1, 5, 0)", "excel": { "bits": null, "display": "#REF!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "start_date", "value": { "bits": null, "display": "#REF!", "kind": "error" } }, { "name": "days", "value": { "bits": "0x4014000000000000", "display": "5", "kind": "number" } }, { "name": "weekend", "value": { "bits": "0x0000000000000000", "display": "0", "kind": "number" } } ], "recorded_in": "Excel 16.0.20527.20088, Windows, bitness and CPU not recorded in this reading file" }, { "call": "WORKDAY.INTL(2, 5, A3)", "excel": { "bits": null, "display": "#NUM!", "kind": "error" }, "input_route": "cell-value2", "inputs": [ { "name": "start_date", "value": { "bits": "0x4000000000000000", "display": "2", "kind": "number" } }, { "name": "days", "value": { "bits": "0x4014000000000000", "display": "5", "kind": "number" } }, { "name": "weekend", "value": { "bits": null, "display": "#REF!", "kind": "error" } } ], "recorded_in": "Excel 16.0.20527.20088, Windows, bitness and CPU not recorded in this reading file" } ], "platform": "Windows, bitness and CPU not recorded in this reading file", "sources": [ "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/3345a87/content/notes/FN-NETWORKDAYS.INTL-001.json" ] }, { "behaviour": "=WORKDAY.INTL(2,2,TRUE) returned 4 (0x4010000000000000). =WORKDAY.INTL(2,2,FALSE) returned #NUM!. 1 further recorded control is attached. Inputs were supplied through cells using Value2, formula literals. These are controls from this environment, not a same-input comparison with another build.", "excel_build": "16.0.20527.20088", "observations": [ { "call": "=WORKDAY.INTL(2,2,TRUE)", "excel": { "bits": "0x4010000000000000", "display": "4", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA" }, { "call": "=WORKDAY.INTL(2,2,FALSE)", "excel": { "bits": null, "display": "#NUM!", "kind": "error" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA" }, { "call": "=WORKDAY.INTL(B1,2,1)", "excel": { "bits": "0x4008000000000000", "display": "3", "kind": "number" }, "input_route": "cell-value2", "inputs": [ { "name": "B1", "value": { "bits": null, "display": "(empty cell)", "kind": "blank" } } ], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA" } ], "platform": "Windows 64-bit (NT 10.0.26200), x86-64, AMD Ryzen 7 4800H, en-ZA", "sources": [ "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/3345a87/content/notes/FN-NETWORKDAYS.INTL-001.json", "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/3345a87/content/notes/FN-WORKDAY-001.json" ] }, { "behaviour": "4,800 captured inputs are indexed for this environment. Capture dates: 2026-09-24 to 2026-09-25. This is a reading count, not a comparison with another build.", "excel_build": "16.0 build 20430", "platform": "Windows, 64-bit, AMD Ryzen 7 4800H with Radeon Graphics", "sources": [ "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.WORKDAY.INTL.json" ] } ] }