updateFormulas

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

Übergeben Sie eine Zuordnung, um Blattnamen pauschal zu ersetzen — der übliche Bedarf nach einer Umbenennung oder Kopie — oder eine Funktion, um jede Formel einzeln zu entscheiden. Die Funktion bekommt die Formel und gibt die zurückzuschreibende zurück.

Besucht werden nur Zellen mit Formeln, geschrieben nur die tatsächlich geänderten; ein Aufruf ohne Änderung kostet also einen Lesevorgang und sonst nichts.

Ein Blatt meint seinen ganzen Datenbereich; ein Bereich meint nur die Zellen darin, sodass sich ein Umschreiben auf einen Block beschränken lässt. Zeile und Spalte, die der Transformer erhält, sind in beiden Fällen Positionen im Blatt — erst das macht die Adresse der Formel selbst im Ersatz brauchbar.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das Blatt, dessen Formeln umgeschrieben werden, oder der Bereich, innerhalb dessen umgeschrieben wird: nur dessen Zellen werden gelesen und geschrieben.
`rewrite`	`FormulaTransformer \\| Record<string, string>`	Eine Zuordnung von altem zu neuem Blattnamen oder eine Funktion, die eine Formel nimmt und ihren Ersatz zurückgibt.

Rückgabewert

number — wie viele Formeln umgeschrieben wurden.

Ausnahmen

Ausnahme	Bedingung
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.

Beispiele

Formeln umschreiben

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

Innerhalb eines Blocks

const sheet = SpreadsheetApp.getActiveSheet();

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

Siehe auch

Quellcode

src/appsscript/sheet/updateFormulas.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.