Skip to main content

List.Percentile

Returns one or more sample percentiles corresponding to the given probabilities.

Syntax

List.Percentile(
list as list,
percentiles as any,
optional options as record
) as any

Remarks

Returns one or more sample percentiles of the list list. If the value percentiles is a number between 0.0 and 1.0, it will be treated as a percentile and the result will be a single value corresponding to that probability. If the value percentiles is a list of numbers with values between 0.0 and 1.0, the result will be a list of percentiles corresponding to the input probability. The PercentileMode option in options can be used by advanced users to pick a more-specific interpolation method but is not recommended for most uses. Predefined symbols PercentileMode.ExcelInc and PercentileMode.ExcelExc match the interpolation methods used by the Excel functions PERCENTILE.INC and PERCENTILE.EXC. The default behavior matches PercentileMode.ExcelInc. The symbols PercentileMode.SqlCont and PercentileMode.SqlDisc match the SQL Server behavior for PERCENTILE_CONT and PERCENTILE_DISC, respectively.

Examples

Example #1

Find the first quartile of the list <code>{5, 3, 1, 7, 9}</code>.

List.Percentile({5, 3, 1, 7, 9}, 0.25)

Result:

3

Example #2

Find the quartiles of the list <code>{5, 3, 1, 7, 9}</code> using an interpolation method matching Excel's <code>PERCENTILE.EXC</code>.

List.Percentile({5, 3, 1, 7, 9}, {0.25, 0.5, 0.75}, [PercentileMode=PercentileMode.ExcelExc])

Result:

{2, 5, 8}

Category

List.Ordering