{ "category": "Text functions", "display_name": "FIXED", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.FIXED", "implementation_state": { "answer_bank": { "excel_builds": [ "20430" ], "larger_numeric": 0, "last_bit": 0, "matched": 201, "other_mismatch": 0, "refused": 788, "rows": 989, "unread": 0, "worst_ulp": 0 }, "detail": "Of 1,000 recorded answers (989 in the answer bank and 11 workbook cells), 788 do not match: 788 are refused.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "differs", "state_label": "Known larger differences", "summary": "Refuses 788 of 1,000 recorded calls; the rest match", "workbook_corpus": { "cells": 11, "matched": 11 } }, "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/text_format.rs#L923-L923", "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/text_format.rs#L158-L164" ], "repository": "https://github.com/DnaCalc/DnaCalc", "shared_code": [ "catalogue/text_format::profile", "catalogue/text_format::rendered", "catalogue/text_format::text", "catalogue/text_format::places", "decimal::low32", "decimal::Natural::zero", "decimal::Natural::from_u64", "decimal::Natural::pow10", "decimal::Natural::normalize", "decimal::Natural::is_zero", "decimal::Natural::mul_add_small", "decimal::Natural::times_pow10", "decimal::Natural::times_pow5", "decimal::Natural::times_pow2", "decimal::ExactDecimal::read", "decimal::ExactDecimal::binary", "format/datetime::has_invalid_exponent", "format/datetime::looks_like_datetime_format", "format/datetime::without_subseconds", "format/datetime::render_with_datetime_tokens", "format/datetime::tokenize_datetime_format", "format/datetime::elapsed_token_at", "format/datetime::classify_minute_tokens", "format/datetime::token_kind", "format/datetime::is_time_neighbor", "format/datetime::push_literal", "format/datetime::render_datetime_literal", "format/datetime::format_elapsed", "format/datetime::TimeParts::from_serial", "format::measured_host", "format::currency_literal", "format::digits", "format::fifteen", "format::split", "format::grouped", "format::fixed", "format::general", "format::significant", "format::sections", "format::bracket", "format::is_condition", "format::is_elapsed", "format::condition_holds", "format::condition_of", "format::strip_tokens", "format::choose", "format::items", "format::numeric", "format::literal_text", "format::integer_part", "format::fraction_part", "format::scientific", "format::fraction_code", "format::FractionCode::render", "format::mixed_fraction_under_space_grouping", "format::convergent", "format::text_declared_date_locale", "format::text", "format::text_of_text", "format/names::month_name", "format/names::weekday_name", "format/names::locale_names", "locale::LocaleId::from_bcp47_language_tag", "locale::LocaleId::from_excel_lcid", "locale::short_date_order", "locale::short_date_pattern", "locale::currency_placement", "locale::currency_spacing", "locale::currency_negative_pattern", "locale::format_profile", "locale::days_from_civil", "locale::civil_from_days", "locale::ymd_from_excel_serial", "number_text::decimal", "number_text::first_precision", "number_text::near_tie", "number_text::first_rounding", "number_text::rounded", "number_text::increment", "number_text::ascii", "ported/date_kernels::whole_serial", "ported/date_kernels::whole", "ported/date_kernels::weekday_sunday_one_based", "ported/date_kernels::remap_weekday", "ported/date_kernels::weekday_of", "ported/date_kernels::weekday", "ported/text_kernels::text", "ported/text_kernels::text_from_str", "ported/text_kernels::date_integer_floor", "ported/text_kernels::push_singleton_or_original", "ported/text_kernels::push_upper", "ported/text_kernels::upper" ], "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/text_format.rs#L923-L923", "state": "differs", "suite": null, "summary": "Refuses 788 of 1,000 recorded calls; the rest match" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.FIXED.json", "name": "FIXED", "notes": [ { "basis": "Four recorded readings of the same value.", "documentation": null, "evidence": [ { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "sheets qt169 to qt172", "note": "recorded readings", "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-text-controls.capture.json", "repository": "DnaCalc" }, { "commit": "2d0eddcac86413014643af81d646581d54ba57bc", "locator": "recorded_dollar_retains_a_negative_sign_after_rounding", "note": "DOLLAR readings pinned", "path": "apps/dna-onecalc/tests/acceptance.rs", "repository": "DnaCalc" } ], "functions": [ "FUNC.DOLLAR", "FUNC.FIXED", "FUNC.TEXT" ], "inferred": null, "kind": "quirk", "note_id": "FN-DOLLAR-001", "open": [], "recorded_on": "2026-11-04", "repros": [ { "call": "=DOLLAR(-0.005,0)", "correct": null, "excel": { "bits": null, "display": "-R0", "kind": "text" }, "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 qt172, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-text-controls.capture.json", "repository": "DnaCalc" } }, { "call": "=FIXED(-0.005,0)", "correct": null, "excel": { "bits": null, "display": "0", "kind": "text" }, "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 qt171, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-text-controls.capture.json", "repository": "DnaCalc" } }, { "call": "=TEXT(-0.005,0)", "correct": null, "excel": { "bits": null, "display": "0", "kind": "text" }, "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 qt169, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-text-controls.capture.json", "repository": "DnaCalc" } }, { "call": "=TEXT(-0.005,\"0\")", "correct": null, "excel": { "bits": null, "display": "0", "kind": "text" }, "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 qt170, row 20, column 10", "note": null, "path": "crates/calc-func/tests/captures/fn4_questions/functions-fn4-text-controls.capture.json", "repository": "DnaCalc" } } ], "schema": "efh.function-note/v1", "statement": "-0.005 rounded to no decimals is zero. DOLLAR(-0.005,0) shows that as -R0 in en-ZA settings, keeping the sign of the input, while FIXED(-0.005,0), TEXT(-0.005,0) and TEXT(-0.005,\"0\") show 0.", "status": "measured", "title": "DOLLAR keeps the minus sign on an amount that rounds to zero; FIXED and TEXT drop it" } ], "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- **`DOLLAR`** is the currency-symbol counterpart: same rounding-then-text shape, plus a\n symbol, and without the `no_commas` switch. See [`DOLLAR`](FUNC.DOLLAR.md).\n- **`TEXT`** is the general form; anything `FIXED` produces can be produced by `TEXT` with an\n appropriate format string, at the cost of writing the format string.\n- **`ROUND`** performs step 2 alone and returns a number. `FIXED` is not a rounding function\n that happens to return text — it is a *rendering* function whose rounding you can specify,\n and the distinction matters because the result cannot be arithmetic on afterwards without\n conversion.\n- **`VALUE`** / **`NUMBERVALUE`** invert it, locale permitting.\n- Excel's *Fixed Decimal* entry option (Advanced settings) shares the word and has nothing to\n do with this function.\n\n\n", "how-to-implement": "\n### Notes for implementers\n\n1. **Round once, render deterministically.** Round-then-format and format-with-precision can\n differ at ties and at values that are not exactly representable; the documented behaviour\n has an explicit rounding step, and it should be a real, separate step.\n2. **Grouping is locale structure, not a comma.** Group size is not universally three, and the\n separator is not universally a comma. `no_commas` should suppress grouping, whatever the\n grouping convention is.\n3. **The 15-significant-digit remark is a real constraint on tests.** A vector suite built from\n decimal literals with more than 15 significant digits is testing the parser, not `FIXED`.\n\n\n", "quirks": "\n### Result and edge cases\n\n\nThe return kind is `Text`.\n\n- **Padding is guaranteed.** `FIXED(44.332)` is documented as `44.33`; a value with fewer\n decimals is padded rather than shortened.\n- **The result is text, and the article says so in contrast with cell formatting**: formatting\n a cell through the Cells command leaves the value a number, while `FIXED` converts its result\n to text. The same downstream trap applies as for `DOLLAR` — a range scan by `SUM` or\n `AVERAGE` ignores numeric-looking text, while the same text passed as a direct argument\n coerces back to a number ([chapter 02](../model/02-coercion-and-lifting.md)).\n- **Negative `decimals` beyond the magnitude of the number** must round the value to zero. How\n the sign of a negative input survives that is not documented, and no negative `decimals` has\n been checked here, but at `decimals` 0 the sign is dropped: `FIXED(-0.005,0)` is `0`\n (FN-DOLLAR-001).\n- Empty cells, omitted arguments and error inputs follow the shared call model.\n\n\n\n### Errors\n\n\nThe article enumerates no error conditions. Reachable errors are the shared ones: an error\nvalue in any argument propagates, and non-numeric text as `number` surfaces `#VALUE!` under the\nshared coercion rules.\n\n`decimals` is documented as admitting values up to 127; what happens beyond that, and what\nhappens for a very large negative `decimals`, is not stated.\n\n\n", "sources": "- Microsoft, \"FIXED function\" —\n \n (the round/format/return-as-text statement; `decimals` defaulting to 2 and negative values\n rounding left of the decimal point; `no_commas`; the 15-significant-digit and 127-decimal\n remark; the contrast with cell formatting; the `1,234.6`, `1,230` and `44.33` examples).\n Retrieved for this page.\n- Microsoft, \"DOLLAR function\" — cited only for the explicit statement that the sibling's\n separators follow language settings:\n \n- Handbook `content/model/02-coercion-and-lifting.md` (the direct-argument versus range-scan\n asymmetry behind the numbers-as-text trap).\n- Handbook `content/evidence/records/EV-STRUCT-0009.json` — cited only to state that `FIXED`\n appears in that run's group member list and is not one of its subjects.\n\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 | 989 |\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.FIXED.json).", "what-it-does": "\n`FIXED` does three things in one call, and Microsoft's article states them in order: it rounds\na number to the specified number of decimals, formats it in decimal format using a period and\ncommas, and returns the result as **text**.\n\nWritten out:\n\n1. convert the argument to a number;\n2. round to `decimals` places, where a negative `decimals` rounds to the left of the decimal\n point (the article's own example: `FIXED(1234.567, -1)` is `1,230`);\n3. render with exactly `decimals` digits after the decimal separator — padding with zeros if\n the value has fewer — and with thousands grouping unless `no_commas` is `TRUE`;\n4. return `Text`.\n\nStep 3 is what distinguishes `FIXED` from `ROUND`: `ROUND(1.5, 2)` is the number 1.5, while\n`FIXED(1.5, 2)` is the text `1.50`. The trailing zero is the point of the function.\n\n\n### Arguments\n\n\n`number` — required, the value to round and convert to text.\n\n`decimals` — optional, the number of digits to the right of the decimal point. **Defaults to\n2** per the article. Negative values round to the left of the decimal point.\n\n`no_commas` — optional logical. When `TRUE`, the returned text contains no thousands\nseparators; commas appear by default. Note the polarity: the argument is a *suppression* flag,\nso the default `FALSE` means \"do include grouping\". This is the argument position readers most\noften invert.\n\nThe article also records a precision remark worth carrying: Excel numbers hold at most 15\nsignificant digits, but `decimals` may be as large as 127. The two facts together mean a large\n`decimals` cannot conjure information — beyond the 15 significant digits available, the extra\nplaces render whatever the binary double actually is, not the decimal literal the user typed.\n\n\n" }, "signature": { "display": "FIXED(number, [decimals], [no_commas])", "parameters": [ { "description": null, "name": "number", "optional": false, "repeats": false }, { "description": null, "name": "decimals", "optional": true, "repeats": false }, { "description": null, "name": "no_commas", "optional": true, "repeats": false } ], "trailing_repeats": false }, "sources": { "metadata": { "admission": { "label": "implemented", "reason": null }, "arity": { "max": 3, "min": 1 }, "category": "Text functions", "classification": { "arg_preparation_profile": "ValuesOnlyPreAdapter", "coercion_lift_profile": "Custom", "determinism_class": "Deterministic", "error_collapse_profile": "None", "fec_dependency_profile": "LocaleProfile", "host_interaction_class": "None", "kernel_signature_class": "Custom", "rich_value_usage": "RichBlind", "surface_fec_dependency_profile": "Composite", "thread_safety_class": "SafePure", "volatility_class": "NonVolatile" }, "descriptions": { "long": null, "short": "A number as text with a fixed number of decimals, with or without thousands separators", "short_source": "dna-calc-own" }, "docs": { "english_description": "Formats a number as text with a fixed number of decimals", "microsoft_url": "https://support.microsoft.com/en-us/office/fixed-function-ffd5723c-324c-45e9-8b96-e41be2a8274a" }, "entry_kind": "built_in_function", "localized_family_names": null, "localized_names": [ { "locale": "ar-SA", "name": "تم التصحيح" }, { "locale": "bg-BG", "name": "ПОПРАВЕНО" }, { "locale": "cs-CZ", "name": "OPRAVENO" }, { "locale": "da-DK", "name": "RETTET" }, { "locale": "de-DE", "name": "BEHOBEN" }, { "locale": "el-GR", "name": "ΔΙΟΡΘΩΘΗΚΕ" }, { "locale": "en-AU", "name": "FIXED" }, { "locale": "en-GB", "name": "FIXED" }, { "locale": "en-US", "name": "FIXED" }, { "locale": "es-ES", "name": "CORREGIDO" }, { "locale": "et-EE", "name": "LAHENDATUD" }, { "locale": "fi-FI", "name": "KORJATTU" }, { "locale": "fr-FR", "name": "RÉSOLU" }, { "locale": "he-IL", "name": "תוקן" }, { "locale": "hr-HR", "name": "RIJEŠENO" }, { "locale": "hu-HU", "name": "JAVÍTVA" }, { "locale": "id-ID", "name": "DIPERBAIKI" }, { "locale": "it-IT", "name": "RISOLTO" }, { "locale": "ja-JP", "name": "修正済み" }, { "locale": "ko-KR", "name": "해결됨" }, { "locale": "lt-LT", "name": "PATAISYTA" }, { "locale": "lv-LV", "name": "IZLABOTS" }, { "locale": "nb-NO", "name": "LØST" }, { "locale": "nl-NL", "name": "OPGELOST" }, { "locale": "pl-PL", "name": "NAPRAWIONE" }, { "locale": "pt-BR", "name": "CORRIGIDO" }, { "locale": "pt-PT", "name": "CORRIGIDO" }, { "locale": "ro-RO", "name": "REMEDIAT" }, { "locale": "ru-RU", "name": "ИСПРАВЛЕНО" }, { "locale": "sk-SK", "name": "OPRAVENÉ" }, { "locale": "sl-SI", "name": "POPRAVLJENO" }, { "locale": "sr-Latn-RS", "name": "POPRAVLJENO" }, { "locale": "sv-SE", "name": "ÅTGÄRDAT" }, { "locale": "th-TH", "name": "แก้ไขแล้ว" }, { "locale": "tr-TR", "name": "DÜZELTİLDİ" }, { "locale": "uk-UA", "name": "ВИПРАВЛЕНО" }, { "locale": "vi-VN", "name": "ĐÃ KHẮC PHỤC" }, { "locale": "zh-CN", "name": "已修复" }, { "locale": "zh-HK", "name": "已修正" }, { "locale": "zh-TW", "name": "已修正" } ], "signature": { "display": "FIXED(number, [decimals], [no_commas])", "parameters": [ { "description": null, "name": "number", "optional": false, "repeats": false }, { "description": null, "name": "decimals", "optional": true, "repeats": false }, { "description": null, "name": "no_commas", "optional": true, "repeats": false } ], "trailing_repeats": false }, "surface_name": "FIXED", "version_marker": null, "xlcall": { "code": "14", "symbol": "xlfFixed" } }, "microsoft": "https://support.microsoft.com/en-us/office/fixed-function-ffd5723c-324c-45e9-8b96-e41be2a8274a" }, "try_it": { "formula": "=FIXED(1234.567, -1)" }, "url": "https://handbook.dnacalc.com/functions/FIXED.html", "variants": [], "versions": [ { "behaviour": "=FIXED(-0.005,0) returned 0. Inputs were supplied through formula literals. These are controls from this environment, not a same-input comparison with another build.", "excel_build": "16.0.20527.20088", "observations": [ { "call": "=FIXED(-0.005,0)", "excel": { "bits": null, "display": "0", "kind": "text" }, "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" } ], "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-DOLLAR-001.json" ] }, { "behaviour": "989 captured inputs are indexed for this environment. Capture dates: 2026-09-25 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.FIXED.json" ] } ] }