{ "category": "Math and trigonometry functions", "display_name": "CEILING.MATH", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.CEILING.MATH", "implementation_state": { "answer_bank": { "excel_builds": [ "20430" ], "larger_numeric": 0, "last_bit": 0, "matched": 1350, "other_mismatch": 0, "refused": 12, "rows": 1362, "unread": 0, "worst_ulp": 0 }, "detail": "Of 1,486 recorded answers (1,362 in the answer bank and 124 workbook cells), 12 do not match: 12 are refused.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "differs", "state_label": "Known larger differences", "summary": "Refuses 12 of 1,486 recorded calls; the rest match", "workbook_corpus": { "cells": 124, "matched": 124 } }, "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/rounding_more.rs#L36-L38" ], "repository": "https://github.com/DnaCalc/DnaCalc", "shared_code": [ "catalogue/rounding_more::three", "ported/ceiling_floor_family::excel_quotient", "ported/ceiling_floor_family::normalize_zero", "ported/ceiling_floor_family::ceiling_math_kernel" ], "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/rounding_more.rs#L36-L38", "state": "differs", "suite": null, "summary": "Refuses 12 of 1,486 recorded calls; the rest match" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.CEILING.MATH.json", "name": "CEILING.MATH", "notes": [], "schema": "efh.function-reference/v1", "section_order": [ "what-it-does", "try-it", "quirks", "how-to-implement", "version-differences", "alternatives" ], "sections": { "alternatives": "\nFor the ordinary input `-10.3` on a grid of magnitude three:\n\n| Function/call | Result |\n|---|---:|\n| `CEILING(-10.3,3)` | -9 |\n| `CEILING(-10.3,-3)` | -12 |\n| `CEILING.PRECISE(-10.3,-3)` | -9 |\n| `CEILING.MATH(-10.3,3,1)` | -12 |\n| `FLOOR.PRECISE(-10.3,-3)` | -12 |\n\n[CEILING.PRECISE](FUNC.CEILING.PRECISE.md) and [ISO.CEILING](FUNC.ISO.CEILING.md) have the fixed upward convention. [FLOOR.MATH](FUNC.FLOOR.MATH.md) selects the other directional default. [MROUND](FUNC.MROUND.md) chooses a nearest multiple.\n\n\n", "how-to-implement": "\n1. Apply omitted defaults: significance one and mode zero. Coerce numeric arguments, retain the distinction between an omitted tail and an explicitly empty slot, and set `s=abs(significance)`. Return zero if s is zero.\n2. For nonnegative input, obtain the current [fifteen-digit quotient reading](FUNC.CEILING.md#how-to-implement) of `number/s`, then take its ceiling.\n3. For negative input, read the positive quotient `abs(number)/s`. Take its floor when mode is zero, or its ceiling when mode is nonzero; restore the negative sign.\n4. The ported modern helper multiplies that count by s with ordinary binary64 arithmetic and normalizes zero. This is distinct from assuming every family spelling uses the native legacy wrapper’s final stored-x87 site. Apply the surrounding number publication rule.\n\nFor `-10.3` and step three, the positive quotient reads near `3.43333333333333`. Default mode chooses three and returns `-9`; nonzero mode chooses four and returns `-12`. The current fractional mode `0.5` follows the nonzero branch too.\n\nThe quotient helper and branch recipe describe the current implementation. [FN-FLOOR-002](../notes/FN-FLOOR-002.json) explicitly leaves transfer of the isolated legacy quotient rule to modern spellings open. Exact edge behaviour and a whole-domain modern-family identification are not established by the shared code alone.\n\n\n", "quirks": "\nThe significance sign is ignored. Mode affects only negative numbers, and the current helper tests zero versus any nonzero mode without truncating the flag. Its zero-significance route returns zero.\n\nThe opened Microsoft page’s argument summary calls significance a count of digits, while its remarks and worked examples use a multiple. Use the multiple interpretation shown here. The current wrapper defaults significance to one when the call ends before it; an explicitly empty slot is read as zero instead.\n\nThe shared current model rounds the quotient to fifteen significant decimal digits before choosing a count. Recorded scope for the legacy FLOOR rule does not by itself establish every modern variant’s quotient edge or last bit.\n\n\n", "sources": "\n- [Microsoft: CEILING.MATH function](https://support.microsoft.com/en-us/excel/functions/ceiling-math-function), opened 6 November 2026; syntax, documented argument rules and errors.\n- [DnaCalc implementation](https://github.com/DnaCalc/DnaCalc/blob/da3ecc4fb19a3a5529708c311d0e8f05688ac165/crates/calc-func/src/catalogue/rounding.rs); implementation steps and the limits identified in the text.\n- [Quotient reading and sign helpers](https://github.com/DnaCalc/DnaCalc/blob/da3ecc4fb19a3a5529708c311d0e8f05688ac165/crates/calc-func/src/ported/ceiling_floor_family.rs).\n- [Modern wrapper defaults](https://github.com/DnaCalc/DnaCalc/blob/da3ecc4fb19a3a5529708c311d0e8f05688ac165/crates/calc-func/src/catalogue/rounding_more.rs).\n\n", "try-it": "\n`=CEILING.MATH(-10.3,3)` returns `-9`; `=CEILING.MATH(-10.3,3,1)` returns `-12`. The nonzero mode changes negative inputs to rounding away from zero. Both answers are multiples of three.\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, CPU not recorded | 1,362 |\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.CEILING.MATH.json).", "what-it-does": "\n`CEILING.MATH(number,[significance],[mode])` rounds to a multiple of the step’s absolute value, which defaults to one. By default, negative numbers move toward zero and positive numbers away from zero. A nonzero mode reverses the negative-input direction. Significance supplies a multiple, rather than a number of decimal places.\n\n\n" }, "signature": { "display": "CEILING.MATH(number, [significance], [mode])", "parameters": [ { "description": null, "name": "number", "optional": false, "repeats": false }, { "description": null, "name": "significance", "optional": true, "repeats": false }, { "description": null, "name": "mode", "optional": true, "repeats": false } ], "trailing_repeats": false }, "sources": { "metadata": { "admission": { "label": "implemented", "reason": null }, "arity": { "max": 3, "min": 1 }, "category": "Math and trigonometry 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": "Number rounded up to a multiple of the significance, with a choice of direction for negative numbers", "short_source": "dna-calc-own" }, "docs": { "english_description": "Rounds a number up, to the nearest integer or to the nearest multiple of significance", "microsoft_url": "https://support.microsoft.com/en-us/office/ceiling-math-function-80f95d2f-b499-4eee-9f16-f795a8e306c8" }, "entry_kind": "built_in_function", "localized_family_names": null, "localized_names": [ { "locale": "ar-SA", "name": "CEILING.MATH" }, { "locale": "bg-BG", "name": "CEILING.MATH" }, { "locale": "cs-CZ", "name": "CEILING.MATH" }, { "locale": "da-DK", "name": "LOFT.MAT" }, { "locale": "de-DE", "name": "CEILING.MATH" }, { "locale": "el-GR", "name": "CEILING.MATH" }, { "locale": "en-AU", "name": "CEILING.MATH" }, { "locale": "en-GB", "name": "CEILING.MATH" }, { "locale": "en-US", "name": "CEILING.MATH" }, { "locale": "es-ES", "name": "MULTIPLO.SUPERIOR.MAT" }, { "locale": "et-EE", "name": "CEILING.MATH" }, { "locale": "fi-FI", "name": "PYÖRISTÄ.KERR.YLÖS.MATEMAATTINEN" }, { "locale": "fr-FR", "name": "PLAFOND.MATH*" }, { "locale": "he-IL", "name": "CEILING.MATH" }, { "locale": "hr-HR", "name": "CEILING.MATH" }, { "locale": "hu-HU", "name": "PLAFON.MAT" }, { "locale": "id-ID", "name": "CEILING.MATH" }, { "locale": "it-IT", "name": "CEILING.MATH" }, { "locale": "ja-JP", "name": "CEILING.MATH" }, { "locale": "ko-KR", "name": "CEILING.MATH" }, { "locale": "lt-LT", "name": "CEILING.MATH" }, { "locale": "lv-LV", "name": "CEILING.MATH" }, { "locale": "nb-NO", "name": "AVRUND.GJELDENDE.MULTIPLUM.OPP.MATEMATISK" }, { "locale": "nl-NL", "name": "AFRONDEN.BOVEN.WISK" }, { "locale": "pl-PL", "name": "ZAOKR.W.GÓRĘ.MATEMATYCZNE" }, { "locale": "pt-BR", "name": "CEILING.MATH" }, { "locale": "pt-PT", "name": "ARRED.EXCESSO.MAT" }, { "locale": "ro-RO", "name": "CEILING.MATH" }, { "locale": "ru-RU", "name": "ОКРВВЕРХ.МАТ" }, { "locale": "sk-SK", "name": "CEILING.MATH" }, { "locale": "sl-SI", "name": "CEILING.MATH" }, { "locale": "sr-Latn-RS", "name": "CEILING.MATH" }, { "locale": "sv-SE", "name": "RUNDA.UPP.MATEMATISKT" }, { "locale": "th-TH", "name": "CEILING.MATH" }, { "locale": "tr-TR", "name": "TAVANAYUVARLA.MATEMATİK" }, { "locale": "uk-UA", "name": "CEILING.MATH" }, { "locale": "vi-VN", "name": "CEILING.MATH" }, { "locale": "zh-CN", "name": "CEILING.MATH" }, { "locale": "zh-HK", "name": "CEILING.MATH" }, { "locale": "zh-TW", "name": "CEILING.MATH" } ], "signature": { "display": "CEILING.MATH(number, [significance], [mode])", "parameters": [ { "description": null, "name": "number", "optional": false, "repeats": false }, { "description": null, "name": "significance", "optional": true, "repeats": false }, { "description": null, "name": "mode", "optional": true, "repeats": false } ], "trailing_repeats": false }, "surface_name": "CEILING.MATH", "version_marker": null, "xlcall": { "code": "591", "symbol": "xlfCeiling_math" } }, "microsoft": "https://support.microsoft.com/en-us/office/ceiling-math-function-80f95d2f-b499-4eee-9f16-f795a8e306c8" }, "try_it": { "formula": "=CEILING.MATH(-10.3,3)" }, "url": "https://handbook.dnacalc.com/functions/CEILING.MATH.html", "variants": [], "versions": [ { "behaviour": "1,362 captured inputs are indexed for this environment. Capture dates: 2026-09-29 to 2026-09-29. This is a reading count, not a comparison with another build.", "excel_build": "16.0 build 20430", "platform": "Windows, 64-bit, CPU not recorded", "sources": [ "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.CEILING.MATH.json" ] } ] }