clearColumnsByConditional

function clearColumnsByConditional(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  predicate: ColumnPredicate,
  options: ColumnConditionalOptions | null | undefined = {}
): number;

clearRowsByConditional um neunzig Grad gedreht: der Inhalt verschwindet, die Spalten bleiben, die Buchstaben der folgenden Spalten ändern sich also nicht.

Das Blatt wird einmal gelesen, das Leeren in zusammenhängende Blöcke gruppiert.

Ein Blatt meint seinen ganzen Datenbereich; ein Bereich meint nur die Zellen darin, der Rest des Blatts wird weder gelesen noch berührt. In beiden Fällen erhält das Prädikat die Position im Blatt, eine Spalte behält also ihre echte Nummer.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das Blatt, auf dem gearbeitet wird, oder der Bereich, innerhalb dessen gearbeitet wird: nur dessen Zellen werden gelesen, und nur sie werden geleert.
`predicate`	`ColumnPredicate`	Bekommt die Zellen der Spalte, ihre einsbasierte Position und — wenn `headerColumn` gesetzt ist — die Spalte mit den Zeilennamen als Schlüsseln. `true` für die Spalten, auf die gewirkt werden soll.
`options` (optional) `= {}`	`ColumnConditionalOptions \\| null \\| undefined`	`headerColumn` benennt die Spalte mit den Zeilennamen und nimmt diese Spalte aus den Kandidaten heraus.

Rückgabewert

number — wie viele betroffen waren.

Ausnahmen

Ausnahme	Bedingung
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.
`IllegalArgumentException`	das Prädikat ist keine Funktion oder die Kopfposition keine positive ganze Zahl.

Beispiele

Im Einsatz

const sheet = SpreadsheetApp.getActiveSheet();

clearColumnsByConditional(sheet, (values) => values.every((cell) => cell === ""));

Innerhalb eines Blocks

const sheet = SpreadsheetApp.getActiveSheet();

// Only B2:Z100 is read, and only those cells are cleared.
clearColumnsByConditional(sheet.getRange("B2:Z100"), (values) =>
  values.every((cell) => cell === "")
);

Siehe auch

Quellcode

src/appsscript/sheet/clearColumnsByConditional.ts

23 September 2026

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