The PIVOTBY function allows you to create a summary of your data via a formula. It supports grouping along two axis and aggregating the associated values. For instance, if you had a table of sales data, you might generate a summary of sales by state and year.
Note: PIVOTBY is a function that returns an array of values that can spill to the grid. A discussion on PIVOTBY and PivotTables can be found here.
Syntax
The PIVOTBY function allows you to group, aggregate, sort, and filter data based on the row and column fields that you specify.
The syntax of the PIVOTBY function is:
PIVOTBY(row_fields,col_fields,values,function,[field_headers],[row_total_depth],[row_sort_order],[col_total_depth],[col_sort_order],[filter_array])
Argument |
Description |
---|---|
row_fields (required) |
A column-oriented array or range that contains the values which are used to group rows and generate row headers. The array or range may contain multiple columns. If so, the output will have multiple row group levels. |
col_fields (required) |
A column-oriented array or range that contains the values which are used to group columns and generate column headers. The array or range may contain multiple columns. If so, the output will have multiple column group levels. |
values (required) |
A column-oriented array or range of the data to aggregate. The array or range may contain multiple columns. If so, the output will have multiple aggregations. |
function (required) |
A lambda function or eta reduced lambda (SUM, AVERAGE, COUNT, etc) that defines how to aggregate the values. A vector of lambdas can be provided. If so, the output will have multiple aggregations. The orientation of the vector will determine whether they are laid out row- or column-wise. |
field_headers |
A number that specifies whether the row_fields, col_fields and values have headers and whether field headers should be returned in the results. The possible values are:
Missing: Automatic. Note: Automatic assumes the data contains headers based on the values argument. If the 1st value is text and the 2nd value is a number, then the data is assumed to have headers. Fields headers are shown if there are multiple row or column group levels. |
row_total_depth |
Determines whether the row headers should contain totals. The possible values are:
Missing: Automatic: Grand totals and, where possible, subtotals. Note: For subtotals, row_fields must have at least 2 columns. Numbers greater than 2 are supported provided row_field has sufficient columns. |
row_sort_order |
A number indicating how rows should be sorted. Numbers correspond with columns in row_fields followed by the columns in values. If the number is negative, the rows are sorted in descending/reverse order. A vector of numbers can be provided when sorting based on only row_fields. |
col_total_depth |
Determines whether the column headers should contain totals. The possible values are:
Missing: Automatic: Grand totals and, where possible, subtotals. Note: For subtotals, col_fields must have at least 2 columns. Numbers greater than 2 are supported provided col_field has sufficient columns. |
col_sort_order |
A number indicating how rows should be sorted. Numbers correspond with columns in col_fields followed by the columns in values. If the number is negative, the rows are sorted in descending/reverse order. A vector of numbers can be provided when sorting based on only col_fields. |
filter_array |
A column-oriented 1D array of Booleans that indicate whether the corresponding row of data should be considered. Note: The length of the array must match the length of those provided to row_fields and col_fields. |
Examples
Example 1: use PIVOTBY to generate a summary of total sales by product and year.
Example 2: use PIVOTBY to generate a summary of total sales by product and year. Sort descending by sales.