updateFormulas

function updateFormulas(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  rewrite: FormulaTransformer | Record<string, string>
): number;

Передайте словарь, чтобы заменить имена листов целиком — обычная нужда после переименования или копирования, — или функцию, чтобы решать по каждой формуле отдельно. Функция получает формулу и возвращает ту, что нужно записать.

Обходятся только ячейки с формулами, а записываются только действительно изменившиеся, поэтому вызов без изменений стоит одного чтения и ничего больше.

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

Параметры

Параметр	Тип	Описание
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Лист, формулы которого переписываем, или диапазон, внутри которого переписываем: читаются и пишутся только его ячейки.
`rewrite`	`FormulaTransformer \\| Record<string, string>`	Словарь «старое имя листа → новое» или функция, принимающая формулу и возвращающая замену.

Возвращает

number — сколько формул было переписано.

Исключения

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

Примеры

Переписывание формул

const sheet = SpreadsheetApp.getActiveSheet();

// After renaming a sheet, point the formulas at the new name.
updateFormulas(sheet, { Sheet1: "Data" });

updateFormulas(sheet, (formula) => formula.replace(/OLD_/g, "NEW_"));

Внутри одного блока

const sheet = SpreadsheetApp.getActiveSheet();

// Only the formulas in D2:D100 are rewritten.
updateFormulas(sheet.getRange("D2:D100"), { "=SUM(A2:A)": "=SUM(A2:A1000)" });

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

Исходный код

src/appsscript/sheet/updateFormulas.ts

23 September 2026

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