{ "category": "Statistical functions", "display_name": "PERCENTRANK.EXC", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.PERCENTRANK.EXC", "implementation_state": { "answer_bank": null, "detail": "Recorded: 55 workbook cells.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "matches", "state_label": "Matches every recorded Excel answer", "summary": "Matches all 55 recorded answers", "workbook_corpus": { "cells": 55, "matched": 55 } }, "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/statistics.rs#L314-L316" ], "repository": "https://github.com/DnaCalc/DnaCalc", "shared_code": [ "catalogue/statistics::list", "catalogue/statistics::percent_rank", "ported/percentrank_common::percentrank", "ported/percentrank_common::exact_rank", "ported/percentrank_common::truncate_to_decimal_places" ], "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/statistics.rs#L314-L316", "state": "matches", "suite": null, "summary": "Matches all 55 recorded answers" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.PERCENTRANK.EXC.json", "name": "PERCENTRANK.EXC", "notes": [], "schema": "efh.function-reference/v1", "section_order": [ "what-it-does", "try-it", "quirks", "how-to-implement", "version-differences", "alternatives" ], "sections": { "alternatives": "\n[PERCENTILE.EXC](FUNC.PERCENTILE.EXC.md) maps a fraction back to a value. [RANK.EQ](FUNC.RANK.EQ.md) returns an integer rank rather than a fraction.\n\n\n", "how-to-implement": "\n1. Collect and sort numeric observations. A query outside their numeric range follows the current helper’s `#N/A` path.\n2. For distinct observations, give zero-based index `i` fraction `(i+1)/(n+1)`.\n3. Find an exact match, or bracket `x` with neighbouring observations. The current interpolation is `lower_rank+(x-lower_x)*(upper_rank-lower_rank)/(upper_x-lower_x)`, with multiplication before division in ordinary binary64.\n4. Truncate the admitted significance to integer `d`; values below one give `#NUM!`. The current helper caps its scale exponent at 308, computes `scale=10^min(d,308)`, then returns `trunc(rank*scale)/scale`.\n\nFor fifteen between ten and twenty, the rank is `0.2+0.5*(0.4-0.2)=0.3`. The precision step discards information, so applying a percentile afterward need not recover the original value exactly.\n\nThe current exact-match branch uses binary search. Which member of a repeated block it selects is a separate implementation and measurement question; the distinct-data example does not establish a duplicate policy. Microsoft’s significant-digit wording and the current decimal-place rule also need to remain distinct.\n\n\n", "quirks": "\nA query outside the numeric data range gives `#N/A` in the current code. Significance below one gives `#NUM!`. Microsoft describes this argument as significant digits; the current helper instead truncates **decimal places**. Microsoft documents `#NUM!` for an empty array, while the current helper returns `#N/A`; that difference remains visible rather than silently promoted to an Excel rule. Duplicate-rank policy needs separate controls.\n\n\n", "sources": "\n- [Microsoft: PERCENTRANK.EXC function](https://support.microsoft.com/en-us/excel/functions/percentrank-exc-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/ported/percentrank_common.rs); implementation steps and the limits identified in the text.\n- [Related precision controls](../notes/FN-PERCENTRANK-001.json): retained PERCENTRANK and PERCENTRANK.INC discriminators; the note does not measure the exclusive precision rule.\n\n", "try-it": "\n`=PERCENTRANK.EXC({10,20,30,40},15)` returns `0.3`. Fifteen is halfway between the first two observations. Their exclusive fractions are `1/5` and `2/5`, so the midpoint is three tenths.\n\nThe endpoints ten and forty have fractions `0.2` and `0.8`. PERCENTRANK.INC instead places them at zero and one. Percent-rank maps a value to standing; PERCENTILE.EXC maps a requested standing to a value.\n\n\n", "version-differences": "No same-input comparison between named Excel builds is recorded for this function here. The documented behaviour below is not a measurement of every Excel release.\n\nThe retained catalogue capture on Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), AMD Ryzen 7 4800H, en-ZA, Workbook Compatibility Version 1 records =PERCENTRANK.EXC({12.7,51.9,92.5},87) = 0.716 (0x3fe6e978d4fdf3b6). Inputs were entered as the shown formula literal. Raw, saved and reopened views belong to one capture; this is not a comparison between builds.", "what-it-does": "\n`PERCENTRANK.EXC(array,x,[significance])` returns x’s fractional standing among numeric observations. The exclusive convention puts observed endpoints strictly between zero and one. The omitted precision argument is three.\n\n\n" }, "signature": { "display": "PERCENTRANK.EXC(array, x, [significance])", "parameters": [ { "description": null, "name": "array", "optional": false, "repeats": false }, { "description": null, "name": "x", "optional": false, "repeats": false }, { "description": null, "name": "significance", "optional": true, "repeats": false } ], "trailing_repeats": false }, "sources": { "metadata": { "admission": { "label": "implemented", "reason": null }, "arity": { "max": 3, "min": 2 }, "category": "Statistical 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": "Relative standing of a value in a data set, with 0 and 1 excluded", "short_source": "dna-calc-own" }, "docs": { "english_description": "Returns the rank of a value in a data set as a percentage (0..1, exclusive) of the data set", "microsoft_url": "https://support.microsoft.com/en-us/office/percentrank-exc-function-d8afee96-b7e2-4a2f-8c01-8fcdedaa6314" }, "entry_kind": "built_in_function", "localized_family_names": null, "localized_names": [ { "locale": "ar-SA", "name": "PERCENTRANK.EXC" }, { "locale": "bg-BG", "name": "PERCENTRANK.EXC" }, { "locale": "cs-CZ", "name": "PERCENTRANK.EXC" }, { "locale": "da-DK", "name": "PROCENTPLADS.UDELAD" }, { "locale": "de-DE", "name": "PERCENTRANK.EXC" }, { "locale": "el-GR", "name": "PERCENTRANK.EXC" }, { "locale": "en-AU", "name": "PERCENTRANK.EXC" }, { "locale": "en-GB", "name": "PERCENTRANK.EXC" }, { "locale": "en-US", "name": "PERCENTRANK.EXC" }, { "locale": "es-ES", "name": "RANGO.PERCENTIL.EXC" }, { "locale": "et-EE", "name": "PERCENTRANK.EXC" }, { "locale": "fi-FI", "name": "PROSENTTIJÄRJESTYS.ULK" }, { "locale": "fr-FR", "name": "RANG.POURCENTAGE.EXCLURE*" }, { "locale": "he-IL", "name": "PERCENTRANK.EXC" }, { "locale": "hr-HR", "name": "PERCENTRANK.EXC" }, { "locale": "hu-HU", "name": "SZÁZALÉKRANG.KIZÁR" }, { "locale": "id-ID", "name": "PERCENTRANK.EXC" }, { "locale": "it-IT", "name": "PERCENTRANK.EXC" }, { "locale": "ja-JP", "name": "PERCENTRANK.EXC" }, { "locale": "ko-KR", "name": "PERCENTRANK.EXC" }, { "locale": "lt-LT", "name": "PERCENTRANK.EXC" }, { "locale": "lv-LV", "name": "PERCENTRANK.EXC" }, { "locale": "nb-NO", "name": "PERCENTRANK.EXC" }, { "locale": "nl-NL", "name": "PROCENTRANG.EXC" }, { "locale": "pl-PL", "name": "PROC.POZ.PRZEDZ.OTW" }, { "locale": "pt-BR", "name": "PERCENTRANK.EXC" }, { "locale": "pt-PT", "name": "ORDEM.PERCENTUAL.EXC" }, { "locale": "ro-RO", "name": "PERCENTRANK.EXC" }, { "locale": "ru-RU", "name": "ПРОЦЕНТРАНГ.ИСКЛ" }, { "locale": "sk-SK", "name": "PERCENTRANK.EXC" }, { "locale": "sl-SI", "name": "PERCENTRANK.EXC" }, { "locale": "sr-Latn-RS", "name": "PERCENTRANK.EXC" }, { "locale": "sv-SE", "name": "PROCENTRANG.EXK" }, { "locale": "th-TH", "name": "PERCENTRANK.EXC" }, { "locale": "tr-TR", "name": "YÜZDERANK.HRC" }, { "locale": "uk-UA", "name": "PERCENTRANK.EXC" }, { "locale": "vi-VN", "name": "PERCENTRANK.EXC" }, { "locale": "zh-CN", "name": "PERCENTRANK.EXC" }, { "locale": "zh-HK", "name": "PERCENTRANK.EXC" }, { "locale": "zh-TW", "name": "PERCENTRANK.EXC" } ], "signature": { "display": "PERCENTRANK.EXC(array, x, [significance])", "parameters": [ { "description": null, "name": "array", "optional": false, "repeats": false }, { "description": null, "name": "x", "optional": false, "repeats": false }, { "description": null, "name": "significance", "optional": true, "repeats": false } ], "trailing_repeats": false }, "surface_name": "PERCENTRANK.EXC", "version_marker": null, "xlcall": { "code": "503", "symbol": "xlfPercentrank_exc" } }, "microsoft": "https://support.microsoft.com/en-us/office/percentrank-exc-function-d8afee96-b7e2-4a2f-8c01-8fcdedaa6314" }, "try_it": { "formula": "=PERCENTRANK.EXC({10,20,30,40},15)" }, "url": "https://handbook.dnacalc.com/functions/PERCENTRANK.EXC.html", "variants": [], "versions": [ { "behaviour": "The retained catalogue capture on Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), AMD Ryzen 7 4800H, en-ZA, Workbook Compatibility Version 1 records =PERCENTRANK.EXC({12.7,51.9,92.5},87) = 0.716 (0x3fe6e978d4fdf3b6). Inputs were entered as the shown formula literal. Raw, saved and reopened views belong to one capture; this is not a comparison between builds.", "excel_build": "16.0.20527.20088", "observations": [ { "call": "=PERCENTRANK.EXC({12.7,51.9,92.5},87)", "excel": { "bits": "0x3fe6e978d4fdf3b6", "display": "0.716", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088 Current Channel, Windows 64-bit (NT 10.0.26200), AMD Ryzen 7 4800H, en-ZA, Workbook Compatibility Version 1" } ], "platform": "Windows 64-bit, AMD Ryzen 7 4800H, en-ZA, Workbook Compatibility Version 1", "sources": [ "https://github.com/DnaCalc/DnaCalc/blob/da3ecc4fb19a3a5529708c311d0e8f05688ac165/crates/calc-func/tests/captures/catalogue/sections/dcj9k_statistics.capture.json" ] } ] }