{
  "category": "Compatibility",
  "display_name": "ECMA.CEILING",
  "entry_kind": "built_in_function",
  "eval_api": {
    "method": "POST",
    "url": "https://handbook.dnacalc.com/api/eval"
  },
  "function_id": "FUNC.ECMA.CEILING",
  "implementation_state": {
    "answer_bank": {
      "excel_builds": [
        "20527"
      ],
      "larger_numeric": 0,
      "last_bit": 0,
      "matched": 6,
      "other_mismatch": 0,
      "refused": 0,
      "rows": 6,
      "unread": 0,
      "worst_ulp": 0
    },
    "detail": "Recorded: 6 in the answer bank.",
    "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87",
    "in_catalogue": true,
    "state": "matches",
    "state_label": "Matches every recorded Excel answer",
    "summary": "Matches all 6 recorded answers",
    "workbook_corpus": null
  },
  "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.rs#L118-L118",
        "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/rounding.rs#L531-L537"
      ],
      "repository": "https://github.com/DnaCalc/DnaCalc",
      "shared_code": [
        "catalogue/rounding::call",
        "catalogue/rounding::numeric",
        "catalogue/rounding::numbers",
        "catalogue/rounding::ceiling_for",
        "catalogue/rounding::to_multiple",
        "catalogue/rounding::quotient",
        "decimal::truncate",
        "decimal::floor",
        "decimal::ceil",
        "ported/ceiling_floor_family::excel_quotient"
      ],
      "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/rounding.rs#L118-L118",
      "state": "matches",
      "suite": null,
      "summary": "Matches all 6 recorded answers"
    }
  ],
  "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.ECMA.CEILING.json",
  "name": "ECMA.CEILING",
  "notes": [],
  "schema": "efh.function-reference/v1",
  "section_order": [
    "what-it-does",
    "try-it",
    "quirks",
    "how-to-implement",
    "version-differences",
    "alternatives"
  ],
  "sections": {
    "alternatives": "\n- `CEILING`, `CEILING.MATH` and `CEILING.PRECISE`, which Microsoft documents.\n\n\n",
    "how-to-implement": "\nShare one kernel with `CEILING`, and keep the entry so that workbooks using the name load and calculate.\n\n\n",
    "quirks": "\nOur implementation treats a zero `number` or `significance` first, as `CEILING` does. The guide for\n[CEILING](FUNC.CEILING.md) holds the sign and multiple rules.\n\n\n",
    "sources": "\n- [Excel functions (alphabetical)](https://support.microsoft.com/en-us/office/excel-functions-alphabetical-b3944572-255d-4efb-bb96-c6d90033e188)\n- [calc-func catalogue, crates/calc-func/src/catalogue/rounding.rs](https://github.com/DnaCalc/DnaCalc/blob/481f4ab85d3bf5a95b6daf959bb75ccb2f8b40f8/crates/calc-func/src/catalogue/rounding.rs)\n\n",
    "version-differences": "\nAnswers recorded here come from Excel 16.0 build 20527. No comparison between builds exists.\n\n\n",
    "what-it-does": "\n`ECMA.CEILING` rounds a number up to a multiple of `significance`.\n\n`ECMA.CEILING(number, significance)`\n\nExcel accepts the name, and answers are recorded here, but it has no page of its own in Microsoft's function list.\nIn our Rust it shares the `CEILING` kernel.\n\n\n"
  },
  "signature": {
    "display": "ECMA.CEILING(number, significance)",
    "parameters": [
      {
        "description": null,
        "name": "number",
        "optional": false,
        "repeats": false
      },
      {
        "description": null,
        "name": "significance",
        "optional": false,
        "repeats": false
      }
    ],
    "trailing_repeats": false
  },
  "sources": {
    "metadata": {
      "admission": {
        "label": "implemented",
        "reason": null
      },
      "arity": {
        "max": 2,
        "min": 2
      },
      "category": "Compatibility",
      "classification": {},
      "descriptions": {
        "long": null,
        "short": "Rounds a number up to a multiple, the form kept for ECMA-376 workbooks",
        "short_source": "dna-calc-own"
      },
      "docs": null,
      "entry_kind": "built_in_function",
      "localized_family_names": null,
      "localized_names": [],
      "signature": {
        "display": "ECMA.CEILING(number, significance)",
        "parameters": [
          {
            "description": null,
            "name": "number",
            "optional": false,
            "repeats": false
          },
          {
            "description": null,
            "name": "significance",
            "optional": false,
            "repeats": false
          }
        ],
        "trailing_repeats": false
      },
      "surface_name": "ECMA.CEILING",
      "version_marker": null,
      "xlcall": null
    },
    "microsoft": null
  },
  "try_it": {
    "formula": "=ECMA.CEILING(2.5,1)"
  },
  "url": "https://handbook.dnacalc.com/functions/ECMA.CEILING.html",
  "variants": [],
  "versions": []
}