updateFormulas

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

Passez une table pour remplacer des noms de feuille en bloc — le besoin habituel après un renommage ou une copie — ou une fonction pour décider de chaque formule. La fonction reçoit la formule et renvoie celle à réécrire.

Seules les cellules contenant une formule sont visitées, et seules celles qui changent réellement sont écrites : un appel sans effet coûte une lecture et rien de plus.

Une feuille désigne toute sa plage de données ; une plage ne désigne que ses cellules, ce qui permet de confiner la réécriture à un bloc. La ligne et la colonne transmises au transformateur sont dans les deux cas des positions dans la feuille, ce qui rend l'adresse de la formule elle-même utilisable dans le remplacement.

Paramètres

Paramètre	Type	Description
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	La feuille dont les formules sont réécrites, ou la plage dans laquelle réécrire : seules ses cellules sont lues et écrites.
`rewrite`	`FormulaTransformer \\| Record<string, string>`	Une table ancien nom de feuille → nouveau, ou une fonction prenant une formule et renvoyant son remplacement.

Valeur de retour

number — le nombre de formules réécrites.

Exceptions

Exception	Condition
`InvalidSheetException`	le premier argument n'est ni une feuille ni une plage.

Exemples

Réécrire des formules

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_"));

Dans un seul bloc

const sheet = SpreadsheetApp.getActiveSheet();

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

Voir aussi

Code source

src/appsscript/sheet/updateFormulas.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.