Diese Seite wurde von der Cloud Translation API übersetzt.

Class FilterCriteriaBuilder

So fügen Sie Kriterien zu einem Filter hinzu:

Erstellen Sie den Builder für Kriterien mit SpreadsheetApp.newFilterCriteria().
Fügen Sie dem Builder mit den Methoden aus dieser Klasse Einstellungen hinzu.
Verwenden Sie build(), um die Kriterien mit den von Ihnen angegebenen Einstellungen zusammenzustellen.

Übliche Anwendungsbereiche

Werte in einem Tabellenblatt ausblenden

Im folgenden Beispiel wird der vorhandene Filter eines Tabellenblatts abgerufen und Kriterien hinzugefügt, durch die die Zellen in Spalte C ausgeblendet werden, die "hello" oder "world" enthalten. Die Kriterien in diesem Beispiel können nur mit Filtern für Grid-Tabellenblätter (Standardblatttyp) verwendet werden.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["hello", "world"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Nur nicht leere Zellen anzeigen

Im folgenden Beispiel wird einem Tabellenblatt DataSource, das mit einer Datenbank verbunden ist, ein Filter mit Kriterien hinzugefügt, die nur Zellen in der Spalte „Kategorie“ anzeigen, die nicht leer sind.

// Gets the sheet named "Connected sheet," which is connected to a database.
let sheet = SpreadsheetApp.getActiveSpreadsheet()
                          .getSheetByName("Connected sheet")
                          .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellNotEmpty()
                             .build();
// Applies the criteria to the column named "Category."
sheet.addFilter("Category", criteria);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`FilterCriteria`	Stellt die Filterkriterien anhand der Einstellungen zusammen, die Sie dem Builder hinzufügen.
`copy()`	`FilterCriteriaBuilder`	Kopiert dieses Filterkriterium und erstellt einen Kriterien-Builder, den Sie auf einen anderen Filter anwenden können.
`getCriteriaType()`	`BooleanCriteria`	Gibt den booleschen Typ des Kriteriums zurück, z. B. `CELL_EMPTY`.
`getCriteriaValues()`	`Object[]`	Gibt ein Array mit Argumenten für boolesche Kriterien zurück.
`getHiddenValues()`	`String[]`	Gibt die Werte zurück, die durch den Filter ausgeblendet werden.
`getVisibleBackgroundColor()`	`Color`	Gibt die als Filterkriterium verwendete Hintergrundfarbe zurück.
`getVisibleForegroundColor()`	`Color`	Gibt die Vordergrundfarbe zurück, die als Filterkriterium verwendet wurde
`getVisibleValues()`	`String[]`	Gibt die Werte zurück, die der Filter für Pivot-Tabellen anzeigt.
`setHiddenValues(values)`	`FilterCriteriaBuilder`	Legt die Werte fest, die ausgeblendet werden sollen.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	Legt die Hintergrundfarbe fest, die als Filterkriterium verwendet wird.
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	Legt die Vordergrundfarbe fest, die als Filterkriterium verwendet wird.
`setVisibleValues(values)`	`FilterCriteriaBuilder`	Legt die Werte fest, die in einer Pivot-Tabelle angezeigt werden sollen.
`whenCellEmpty()`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass leere Zellen angezeigt werden.
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass nicht leere Zellen angezeigt werden.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die nach dem angegebenen Datum liegen.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die nach dem angegebenen relativen Datum liegen.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die vor dem angegebenen Datum liegen.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die vor dem angegebenen relativen Datum liegen.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die dem angegebenen Datum entsprechen.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die dem angegebenen relativen Datum entsprechen.
`whenDateEqualToAny(dates)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Datumsangaben angezeigt werden, die einem der angegebenen Daten entsprechen.
`whenDateNotEqualTo(date)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen angezeigt werden, die nicht dem angegebenen Datum entsprechen.
`whenDateNotEqualToAny(dates)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Datumsangaben angezeigt werden, die keinem der angegebenen Daten entsprechen.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer angegebenen Formel (z. B. `=B:B<C:C`) angezeigt werden, die als `true` ausgewertet wird.
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die zwischen zwei angegebenen Zahlen liegt oder eine dieser Zahlen ist.
`whenNumberEqualTo(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die der angegebenen Zahl entspricht.
`whenNumberEqualToAny(numbers)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die einer der angegebenen Zahlen entspricht.
`whenNumberGreaterThan(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Zahl größer als die angegebene Zahl ist
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die größer oder gleich der angegebenen Zahl ist.
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die kleiner als die angegebene Zahl ist.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die kleiner oder gleich der angegebenen Zahl ist.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die nicht zwischen zwei angegebenen Zahlen liegt oder diese nicht enthält.
`whenNumberNotEqualTo(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die nicht der angegebenen Zahl entspricht.
`whenNumberNotEqualToAny(numbers)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die keiner der angegebenen Zahlen entspricht.
`whenTextContains(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text den angegebenen Text enthält.
`whenTextDoesNotContain(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der den angegebenen Text nicht enthält.
`whenTextEndsWith(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text endet.
`whenTextEqualTo(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der dem angegebenen Text entspricht.
`whenTextEqualToAny(texts)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der einem der angegebenen Textwerte entspricht.
`whenTextNotEqualTo(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der nicht dem angegebenen Text entspricht.
`whenTextNotEqualToAny(texts)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der keinem der angegebenen Werte entspricht.
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text beginnt.
`withCriteria(criteria, args)`	`FilterCriteriaBuilder`	Legt die Filterkriterien auf eine boolesche Bedingung fest, die durch `BooleanCriteria`-Werte wie `CELL_EMPTY` oder `NUMBER_GREATER_THAN` definiert ist.

Detaillierte Dokumentation

`build()`

Stellt die Filterkriterien anhand der Einstellungen zusammen, die Sie dem Builder hinzufügen.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria() // Creates a criteria builder.
                             .whenCellNotEmpty() // Adds settings to the builder.
                             .build();          // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteria: Eine Darstellung der Filterkriterien.

`copy()`

Kopiert dieses Filterkriterium und erstellt einen Kriterien-Builder, den Sie auf einen anderen Filter anwenden können.

Sie können diese Methode mit allen Arten von Filtern verwenden. Wenn Sie einen Tabellenblattfilter verwenden, können Sie die Kriterien in eine andere Spalte kopieren.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
let criteria = filter.getColumnFilterCriteria(3).copy().build();
// Applies the copied criteria to column B. The copied criteria overwrites any existing
// criteria on column B.
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Ein Builder für Filterkriterien, der auf diesem Filterkriterium basiert.

`getCriteriaType()`

Gibt den booleschen Typ des Kriteriums zurück, z. B. CELL_EMPTY. Weitere Informationen zu den Arten boolescher Kriterien finden Sie in der BooleanCriteria-Enum.

Diese Methode wird häufig verwendet, um einem Filter boolesche Bedingungskriterien hinzuzufügen, ohne vorhandene Kriterien zu ersetzen.

Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen.
Informationen zum Erstellen oder Ändern von Filterkriterien mithilfe des Kriterientyps und der Kriterienwerte finden Sie unter withCriteria(criteria, args).

Sie können diese Methode für alle Arten von Filtern verwenden. Wenn das Filterkriterium keine boolesche Bedingung ist, wird null zurückgegeben.

let ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
let filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type object.
let criteriaType = filter.getColumnFilterCriteria(2)
                         .getCriteriaType()
                         .toString();
// Logs the criteria type.
console.log(criteriaType);

Return

BooleanCriteria: Der Typ des booleschen Kriteriums oder null, wenn das Kriterium keine boolesche Bedingung ist.

`getCriteriaValues()`

Gibt ein Array mit Argumenten für boolesche Kriterien zurück. Einige boolesche Kriterientypen haben keine Argumente und geben ein leeres Array zurück, z. B. CELL_NOT_EMPTY.

Diese Methode wird häufig verwendet, um einem Filter boolesche Bedingungskriterien hinzuzufügen, ohne vorhandene Kriterien zu ersetzen.

Verwenden Sie getCriteriaType(), um den booleschen Kriterientyp abzurufen.
Informationen zum Erstellen oder Ändern von Filterkriterien mithilfe des Kriterientyps und der Kriterienwerte finden Sie unter withCriteria(criteria, args).
Sie können diese Methode für alle Arten von Filtern verwenden.
```
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Gets the values of the boolean criteria and logs them. For example, if the boolean
// condition is whenNumberGreaterThan(10), then the logged value is 10.
let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
console.log(criteriaValues);
```
Return

Object[]: Ein Array von Argumenten, die dem booleschen Kriteriumstyp entsprechen. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden when...()-Methode der FilterCriteriaBuilder-Klasse überein.

`getHiddenValues()`

Gibt die Werte zurück, die durch den Filter ausgeblendet werden.

Du kannst dieses Kriterium mit Filtern für Grid Tabellenblätter verwenden. Dies ist der Standardtyp von Tabellenblättern. Gibt null zurück, wenn Sie diese Methode für andere Filtertypen aufrufen.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

Return

String[]: Ein Array von Werten, die durch den Filter ausgeblendet werden.

`getVisibleBackgroundColor()`

Gibt die als Filterkriterium verwendete Hintergrundfarbe zurück. Zellen mit dieser Hintergrundfarbe bleiben sichtbar.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the background color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

Return

Color: Die Hintergrundfarbe, die als Filterkriterium verwendet wird.

`getVisibleForegroundColor()`

Gibt die Vordergrundfarbe zurück, die als Filterkriterium verwendet wurde Zellen mit dieser Vordergrundfarbe bleiben sichtbar.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the foreground color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

Return

Color: Die Vordergrundfarbe, die als Filterkriterium verwendet wird.

`getVisibleValues()`

Gibt die Werte zurück, die der Filter für Pivot-Tabellen anzeigt.

Dieses Kriterium gilt nur für Filter für Pivot-Tabellen, die nicht mit einer Datenbank verbunden sind. Gibt ein leeres Array für andere Filtertypen zurück.

let ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its first filter.
pivotTable = ss.getPivotTables()[0];
pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

Return

String[]: Ein Array von Werten, das der Pivot-Tabellenfilter anzeigt.

`setHiddenValues(values)`

Legt die Werte fest, die ausgeblendet werden sollen. Löscht alle vorhandenen sichtbaren oder ausgeblendeten Werte.

Sie können dieses Kriterium nur für Filter in Grid-Tabellenblättern (Standardblatttyp) verwenden.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["Hello", "World"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	Die Liste der auszublendenden Werte.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`setVisibleBackgroundColor(visibleBackgroundColor)`

Legt die Hintergrundfarbe fest, die als Filterkriterium verwendet wird. Zellen mit dieser Hintergrundfarbe bleiben sichtbar. Wenn Sie Kriterien für Hintergrundfarbenfilter festlegen, werden alle aktuellen Farbfilterkriterien aus diesem Builder entfernt.

Sie können dieses Kriterium nur für Filter in Grid-Tabellenblättern (Standardblatttyp) verwenden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleBackgroundColor(color)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`visibleBackgroundColor`	`Color`	Die festzulegende Hintergrundfarbe. Die Farbe muss im RGB-Stil erfolgen. Designfarben werden von dieser Methode nicht unterstützt.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`setVisibleForegroundColor(visibleForegroundColor)`

Legt die Vordergrundfarbe fest, die als Filterkriterium verwendet wird. Zellen mit dieser Vordergrundfarbe bleiben sichtbar. Wenn Sie Filterkriterien für Vordergrundfarben festlegen, werden alle aktuellen Farbfilterkriterien aus diesem Builder entfernt.

Sie können dieses Kriterium nur für Filter in Grid-Tabellenblättern (Standardblatttyp) verwenden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleForegroundColor(color)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`visibleForegroundColor`	`Color`	Die festzulegende Vordergrundfarbe. Die Farbe muss im RGB-Stil erfolgen. Designfarben werden von dieser Methode nicht unterstützt.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`setVisibleValues(values)`

Legt die Werte fest, die in einer Pivot-Tabelle angezeigt werden sollen. Löscht alle vorhandenen sichtbaren oder ausgeblendeten Werte.

Sie können dieses Kriterium nur für Filter für Pivot-Tabellen verwenden, die nicht mit einer Datenbank verbunden sind.

// Gets the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet and adds a filter to it that
// sets the visible values to "Northeast" and "Southwest."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	Die Liste der anzuzeigenden Werte.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenCellEmpty()`

Legt die Filterkriterien so fest, dass leere Zellen angezeigt werden.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets criteria to column B that only shows empty cells.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellEmpty()
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenCellNotEmpty()`

Legt die Filterkriterien so fest, dass nicht leere Zellen angezeigt werden.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets criteria to column B that only shows cells that aren't empty.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellNotEmpty()
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateAfter(date)`

Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die nach dem angegebenen Datum liegen.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, kein Datum sein. Ist das nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateAfter(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das letzte ausgeblendete Datum.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateAfter(date)`

Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die nach dem angegebenen relativen Datum liegen. Informationen zu den relativen Datumsoptionen finden Sie unter Enum RelativeDate.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.TODAY;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateAfter(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das letzte relative Datum.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateBefore(date)`

Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die vor dem angegebenen Datum liegen.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateBefore(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste Datum, das ausgeblendet werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateBefore(date)`

Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die vor dem angegebenen relativen Datum liegen. Informationen zu den relativen Datumsoptionen finden Sie unter Enum RelativeDate.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.TODAY;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateBefore(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das früheste relative Datum, das ausgeblendet werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateEqualTo(date)`

Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die dem angegebenen Datum entsprechen.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das Datum, mit dem die Zellenwerte übereinstimmen müssen.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateEqualTo(date)`

Legt Filterkriterien fest, die Zellen mit Datumsangaben anzeigen, die dem angegebenen relativen Datum entsprechen. Informationen zu den relativen Datumsoptionen finden Sie unter Enum RelativeDate.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past month
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.PAST_MONTH;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das relative Datum, mit dem die Zellenwerte übereinstimmen müssen.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateEqualToAny(dates)`

Legt die Filterkriterien so fest, dass Zellen mit Datumsangaben angezeigt werden, die einem der angegebenen Daten entsprechen.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Verwenden Sie dieses Kriterium beispielsweise mit Filtern für ein DataSource-Tabellenblatt, ein mit einer Datenbank verbundenes Tabellenblatt oder ein DataSourcePivotTable, eine Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below dates.
let date1 = new Date("June 1, 2022");
let date2 = new Date("June 2, 2022");
let date3 = new Date("June 3, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualToAny([date1, date2, date3])
                             .build();
dataSheet.addFilter("date", criteria);

Parameter

Name	Typ	Beschreibung
`dates`	`Date[]`	Die anzuzeigenden Daten.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateNotEqualTo(date)`

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, die nicht dem angegebenen Datum entsprechen.

Der Datentyp der Spalte, nach der Sie filtern, muss ein Datum sein.

// Gets a pivot table that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Pivot Table Sheet");
let dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
let date = new Date("June 16, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateNotEqualTo(date)
                             .build();
dataPivotTable.addFilter("date", criteria);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das Datum, das ausgeblendet werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenDateNotEqualToAny(dates)`

Legt die Filterkriterien so fest, dass Zellen mit Datumsangaben angezeigt werden, die keinem der angegebenen Daten entsprechen.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below dates.
let date1 = new Date("June 1, 2022");
let date2 = new Date("June 2, 2022");
let date3 = new Date("June 3, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateNotEqualToAny([date1, date2, date3])
                             .build();
dataSheet.addFilter("date", criteria);

Parameter

Name	Typ	Beschreibung
`dates`	`Date[]`	Die Daten, die ausgeblendet werden sollen.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenFormulaSatisfied(formula)`

Legt die Filterkriterien so fest, dass Zellen mit einer angegebenen Formel (z. B. =B:B<C:C) angezeigt werden, die als true ausgewertet wird.

Sie können dieses Kriterium nur zum Filtern von Daten verwenden, die nicht mit einer Datenbank verbunden sind.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows the rows where the value in column B is less than the value in
// column C and sets it to column A.
let formula = "=B:B<C:C";
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenFormulaSatisfied(formula)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Eine benutzerdefinierte Formel, die `true` ergibt, wenn die Eingabe gültig ist.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberBetween(start, end)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die zwischen zwei angegebenen Zahlen liegt oder eine dieser Zahlen ist.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25, inclusively,
// and sets it to column A.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberBetween(1, 25)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Die niedrigste Zahl, die angezeigt werden soll.
`end`	`Number`	Die höchste Zahl, die angezeigt werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberEqualTo(number)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die der angegebenen Zahl entspricht.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberEqualTo(25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Die Zahl, die angezeigt werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberEqualToAny(numbers)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die einer der angegebenen Zahlen entspricht.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number 10, 20, or 30.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberEqualToAny([10,20,30])
                             .build();
dataSheet.addFilter("amount", criteria);

Parameter

Name	Typ	Beschreibung
`numbers`	`Number[]`	Die anzuzeigenden Zahlen.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberGreaterThan(number)`

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Zahl größer als die angegebene Zahl ist

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberGreaterThan(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Die höchste Zahl, die ausgeblendet werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberGreaterThanOrEqualTo(number)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die größer oder gleich der angegebenen Zahl ist.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberGreaterThanOrEqualTo(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Die niedrigste Zahl, die angezeigt werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberLessThan(number)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die kleiner als die angegebene Zahl ist.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberLessThan(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Die niedrigste Zahl, die ausgeblendet werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberLessThanOrEqualTo(number)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die kleiner oder gleich der angegebenen Zahl ist.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberLessThanOrEqualTo(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Die höchste Zahl, die angezeigt werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberNotBetween(start, end)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die nicht zwischen zwei angegebenen Zahlen liegt oder diese nicht enthält.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25, inclusively,
// and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotBetween(1, 25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Die niedrigste Nummer wird ausgeblendet.
`end`	`Number`	Die höchste Zahl, die ausgeblendet werden soll.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberNotEqualTo(number)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die nicht der angegebenen Zahl entspricht.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden. Wenn Sie dieses Kriterium mit Daten verwenden, die mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn die Daten nicht mit einer Datenbank verbunden sind, muss der Datentyp der Spalte, nach der Sie filtern, keine Zahl sein. Ist dies nicht der Fall, erhalten Sie möglicherweise unerwartete Ergebnisse.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotEqualTo(25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Die Zahl, die ausgeblendet werden soll

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenNumberNotEqualToAny(numbers)`

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die keiner der angegebenen Zahlen entspricht.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20, or 30.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotEqualToAny([10,20,30])
                             .build();
dataSheet.addFilter("amount", criteria);

Parameter

Name	Typ	Beschreibung
`numbers`	`Number[]`	Die Zahlen, die ausgeblendet werden sollen.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextContains(text)`

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text den angegebenen Text enthält. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextContains("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, den die Zelle enthalten muss

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextDoesNotContain(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der den angegebenen Text nicht enthält. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextDoesNotContain("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, den die Zelle nicht enthalten darf

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextEndsWith(text)`

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text endet. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEndsWith("est")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, den das Ende des Zellentexts enthalten muss

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextEqualTo(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der dem angegebenen Text entspricht. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualTo("hello")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, mit dem der Zellentext übereinstimmen muss

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextEqualToAny(texts)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der einem der angegebenen Textwerte entspricht. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

Name	Typ	Beschreibung
`texts`	`String[]`	Die Textwerte, die eine Zelle entsprechen muss.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextNotEqualTo(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der nicht dem angegebenen Text entspricht. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to "tech."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualTo("tech")
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, mit dem der Zellentext nicht übereinstimmen muss

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextNotEqualToAny(texts)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der keinem der angegebenen Werte entspricht. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

Name	Typ	Beschreibung
`texts`	`String[]`	Textwerte, die in einer Zelle nicht übereinstimmen dürfen.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`whenTextStartsWith(text)`

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text beginnt. Die Groß- und Kleinschreibung spielt dabei keine Rolle.

Dieses Kriterium kann mit jedem Filtertyp verwendet werden.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextStartsWith("pre")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, den der Anfang des Zellentexts enthalten muss

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

`withCriteria(criteria, args)`

Legt die Filterkriterien auf eine boolesche Bedingung fest, die durch BooleanCriteria-Werte wie CELL_EMPTY oder NUMBER_GREATER_THAN definiert ist. Wenn Sie die boolesche Bedingung aus einem vorhandenen Kriterium kopieren möchten, definieren Sie die Parameter für diese Methode mithilfe von getCriteriaType() und getCriteriaValues() für ein vorhandenes Kriterium.

Sie können dieses Kriterium mit jeder Art von Filter verwenden, aber einige BooleanCriteria gelten nicht für alle Filter.

// Builds a filter criteria that is based on existing boolean conditions from another criteria.
// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Gets the existing boolean conditions applied to Column B and adds criteria to column C that
// has the same boolean conditions and additional criteria that hides the value, "Northwest."
let filter = ss.getFilter();
let filterCriteria = filter.getColumnFilterCriteria(2);
let criteria = SpreadsheetApp.newFilterCriteria()
    .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues())
    .setHiddenValues(["Northwest"])
    .build();
filter.setColumnFilterCriteria(3, criteria);

Parameter

Name	Typ	Beschreibung
`criteria`	`BooleanCriteria`	Der Typ der booleschen Kriterien.
`args`	`Object[]`	Ein Array mit Argumenten entsprechend dem Kriterientyp. Die Anzahl der Argumente und ihr Typ stimmen mit den entsprechenden `when...()`-Methoden oben überein.

Return

FilterCriteriaBuilder: Dieser Builder für Verkettungen.