prependColumns

function prependColumns(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  count: number,
  values?: unknown[][] | null,
  options: Options | null | undefined = {}
): GoogleAppsScript.Spreadsheet.Sheet;

Сначала освобождается место, затем в него пишутся значения, поэтому ничего из того, что уже на листе, не перезаписывается. Передан лист — столбцы идут в его начало; передан диапазон — перед первым столбцом диапазона, а значения пишутся по его строкам.

Матрица индексируется сначала по строке, затем по столбцу, и её ширина должна быть ровно count. Без значений вставляются пустые столбцы.

Ячейка, текст которой начинается с =, записывается как формула, а не как текст — по тому же правилу, что и в редакторе.

Параметры

Параметр	Тип	Описание
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Лист, в который вставляем, или диапазон, у которого вставляем.
`count`	`number`	Сколько столбцов вставить. `0` не делает ничего.
`values` (необязательный)	`unknown[][] \\| null`	Матрица по строкам и столбцам шириной ровно `count`. Без неё вставляются пустые столбцы.
`options` (необязательный) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` вставляет после закреплённых столбцов, а не в самое начало. Диапазон задаёт позицию сам, поэтому там опция ничего не меняет.

Возвращает

GoogleAppsScript.Spreadsheet.Sheet — лист, чтобы вызовы можно было объединять в цепочку.

Исключения

Исключение	Условие
`IllegalArgumentException`	`count` не является неотрицательным безопасным целым, или значения ему не соответствуют.
`InvalidSheetException`	первый аргумент не является ни листом, ни диапазоном.

Примеры

Вставка в начало листа

const sheet = SpreadsheetApp.getActiveSheet();

prependColumns(sheet, 2, [
  ["A1", "B1"],
  ["A2", "B2"]
]);

Вставка у диапазона

const sheet = SpreadsheetApp.getActiveSheet();

prependColumns(sheet.getRange("C4:F13"), 1, [["note"]]);

Смотрите также

Исходный код

src/appsscript/sheet/prependColumns.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.