# AGGREGATE

math · from excel · excel: differs in detail · no sheets equivalent

aggregates a range with a chosen function, optionally ignoring error values

## signature

```
AGGREGATE(function_num, options, range…)
```

returns: `number`

## arguments

- function_num: number — required
- options: number — required
- range: range — required, repeatable

## examples

formula and result, asserted in the engine test suite.

| formula | result | with |
| --- | --- | --- |
| `=AGGREGATE(9, 6, A1:A5)` | `150` | A1=10, A2=20, A3=30, A4=40, A5=50 |

## related

- [ABS](https://deepcalc.com/functions/abs.md) — returns absolute value of a number
- [ACOS](https://deepcalc.com/functions/acos.md) — returns arccosine of a number
- [ACOSH](https://deepcalc.com/functions/acosh.md) — returns inverse hyperbolic cosine
- [ACOT](https://deepcalc.com/functions/acot.md) — returns the arccotangent of a number
- [ACOTH](https://deepcalc.com/functions/acoth.md) — returns the inverse hyperbolic cotangent
- [ADD](https://deepcalc.com/functions/add.md) — adds two numbers — sheets exposes the + operator as a function
- [ARABIC](https://deepcalc.com/functions/arabic.md) — converts roman numeral to arabic number
- [ASIN](https://deepcalc.com/functions/asin.md) — returns arcsine of a number

## navigate

- [all math functions](https://deepcalc.com/functions/math-functions.md)
- [function index](https://deepcalc.com/functions.md) — all 600 functions
- [error values](https://deepcalc.com/errors.md) · [concepts](https://deepcalc.com/concepts.md) · [limits](https://deepcalc.com/limits.md)
- [everything in one file](https://deepcalc.com/llms-full.txt)

source: https://deepcalc.com/functions/aggregate