sortRange

сортирует ячейки

void sortRange( [string range,string|object config] );

range	string	необязательный параметр, диапазон ячеек, которые нужно отсортировать; `null`, чтобы отсортировать выбранный диапазон
config	string\|object	необязательный параметр, направление сортировки: "asc" или "desc" (по умолчанию "asc"), либо объект для настройки сортировки по нескольким столбцам

Example

// сортирует ячейки с B2 по B4 по возрастанию ("asc")
$$("ssheet").sortRange("B2:B4");
// сортирует ячейки с B2 по B4 по убыванию ("desc")
$$("ssheet").sortRange("B2:B4", "desc");
// сортирует выбранные ячейки по убыванию ("desc")
$$("ssheet").sortRange(null,"desc");
// сортирует диапазон A1:C10 по столбцу B (по возрастанию), затем по столбцу C (по убыванию)
$$("ssheet").sortRange("A1:C10", {
    hasHeaders: true,
    levels: [
        { column: "B", direction: "asc" },
        { column: "C", direction: "desc" }
    ]
});

Related samples

Sorting in SpreadSheet

Details

Параметр range не поддерживает несколько диапазонов.

Объект для настройки сортировки по нескольким столбцам в параметре config имеет следующую структуру:

{
    hasHeaders: boolean; 
    levels: [
        { column: string | number, direction: string },
        ...
    ]
}

Значения по умолчанию для объекта config:

{
    hasHeaders: false,
    levels: [
        { 
            column: range.start.column, // id первого столбца сортируемого диапазона
            direction: "asc" 
        }
    ]
}

где:

hasHeaders - (boolean) по умолчанию false. Соответствует чекбоксу в диалоге пользовательской сортировки:

Если true, первая строка выбранного диапазона ячеек будет считаться заголовком, и вместо Столбец A, B, C в выпадающем списке Сортировать по будут отображаться названия этих заголовков:

levels - (array) массив объектов столбцов, по которым выполняется сортировка. Каждый объект столбца включает:
- column - (string|number) обязательный, идентификатор столбца в виде строки (например "A", "AA" или "X" и т.д.) или числа (1, 2 и т.д.)
- direction - (string) необязательный, направление сортировки: "asc" или "desc" (по умолчанию "asc")

Порядок уровней имеет значение: именно в таком порядке конфигурация сортировки столбцов будет применяться к данным. Уровни 2 и далее являются «разрешителями равенства» и применяются только в случае, если предыдущее сравнение завершилось вничью (оба значения равны).