Diese Seite wurde von der Cloud Translation API übersetzt.

Class FilterCriteriaBuilder

So fügen Sie einem Filter Kriterien hinzu:

Erstellen Sie mit SpreadsheetApp.newFilterCriteria() das Tool zur Kriterienerstellung.
Fügen Sie dem Builder Einstellungen mit den Methoden aus dieser Klasse hinzu.
Mit build() können Sie die Kriterien mit den von Ihnen angegebenen Einstellungen zusammenstellen.

Übliche Anwendungsbereiche

Werte auf einem Tabellenblatt ausblenden

Im folgenden Beispiel wird ein Filter für ein Tabellenblatt abgerufen und Kriterien hinzugefügt, die die Zellen in Spalte C ausblenden, die "hello" oder "world."" enthalten. Die Kriterien in diesem Beispiel können nur mit Filtern für Grid Tabellenblätter, den Standardtyp des Tabellenblatts, 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 ein Filter auf ein DataSource-Tabellenblatt angewendet, ein Tabellenblatt, das mit einer Datenbank verbunden ist und dessen Kriterien nur Zellen in der Spalte "Kategorie" enthalten, 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`	Stellen Sie die Filterkriterien mit den Einstellungen zusammen, die Sie dem Tool zur Kriterienerstellung hinzufügen.
`copy()`	`FilterCriteriaBuilder`	Kopiert diese Filterkriterien 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 von Argumenten für boolesche Kriterien zurück.
`getHiddenValues()`	`String[]`	Gibt die Werte zurück, die mit dem Filter ausgeblendet werden.
`getVisibleBackgroundColor()`	`Color`	Gibt die Hintergrundfarbe zurück, die als Filterkriterium verwendet wird.
`getVisibleForegroundColor()`	`Color`	Gibt die Vordergrundfarbe zurück, die als Filterkriterium verwendet wird.
`getVisibleValues()`	`String[]`	Gibt die Werte zurück, die im Filter der Pivot-Tabelle angezeigt werden.
`setHiddenValues(values)`	`FilterCriteriaBuilder`	Legt die Werte fest, die ausgeblendet werden sollen.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	Legt die Hintergrundfarbe als Filterkriterium fest.
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	Legt die Vordergrundfarbe als Filterkriterium fest.
`setVisibleValues(values)`	`FilterCriteriaBuilder`	Legt die Werte fest, die in einer Pivot-Tabelle angezeigt werden.
`whenCellEmpty()`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass leere Zellen angezeigt werden.
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen angezeigt werden, die nicht leer sind.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, bei denen Zellen angezeigt werden, deren Datum nach dem angegebenen Datum liegt.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, bei denen Zellen angezeigt werden, deren Datum nach dem angegebenen relativen Datum liegt.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, bei denen Zellen vor dem angegebenen Datum zu sehen sind.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, bei denen Zellen mit Datumsangaben angezeigt werden, die vor dem angegebenen relativen Datum liegen.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, bei denen Zellen mit dem angegebenen Datum angezeigt werden.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Legt Filterkriterien fest, bei denen Zellen angezeigt werden, die mit dem angegebenen relativen Datum übereinstimmen.
`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 bestimmten 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 entweder 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 mit einer Zahl größer als die angegebene Zahl angezeigt werden
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit einer Zahl größer oder gleich der angegebenen Zahl angezeigt werden.
`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 kleiner oder gleich der angegebenen Anzahl angezeigt werden.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die nicht zwischen 2 angegebenen Zahlen liegen und keine davon ist.
`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 mit Text angezeigt werden, der 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 mit Text angezeigt werden, der 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 fest, damit 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 Text in Zellen angezeigt wird, die keinem der angegebenen Werte entsprechen.
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der 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 wird.

Detaillierte Dokumentation

`build()`

Stellen Sie die Filterkriterien mit den Einstellungen zusammen, die Sie dem Tool zur Kriterienerstellung 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);

Zurücksenden

FilterCriteria: Eine Darstellung der Filterkriterien.

`copy()`

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

Sie können diese Methode mit jedem beliebigen Filtertyp 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);

Zurücksenden

FilterCriteriaBuilder: Ein Filterkriterien-Builder, das auf diesen Filterkriterien basiert.

`getCriteriaType()`

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

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.
Wie Sie Filterkriterien erstellen oder ändern, erfahren Sie unter withCriteria(criteria, args).

Sie können diese Methode für jede Art von Filter verwenden. Wenn die Filterkriterien keine boolesche Bedingung sind, 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);

Zurücksenden

BooleanCriteria: Der Typ der booleschen Kriterien oder null, wenn die Kriterien keine boolesche Bedingung sind.

`getCriteriaValues()`

Gibt ein Array von 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.

Rufen Sie den booleschen Kriterientyp mit getCriteriaType() ab.
Wie Sie Filterkriterien erstellen oder ändern, erfahren Sie unter withCriteria(criteria, args).
Sie können diese Methode für jede Art von Filter 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);
```
Zurücksenden

Object[]: Ein Array von Argumenten, die dem booleschen Kriterientyp 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 mit dem Filter ausgeblendet werden.

Verwenden Sie dieses Kriterium mit Filtern für Grid Tabellenblätter, den 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);

Zurücksenden

String[]: Ein Array von Werten, die der Filter ausgeblendet.

`getVisibleBackgroundColor()`

Gibt die Hintergrundfarbe zurück, die als Filterkriterium verwendet wird. Zellen mit dieser Hintergrundfarbe sind weiterhin sichtbar.

Verwenden Sie dieses Kriterium mit Filtern für Grid Tabellenblätter, den 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");
// 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);

Zurücksenden

Color: Die als Filterkriterium verwendete Hintergrundfarbe.

`getVisibleForegroundColor()`

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

Verwenden Sie dieses Kriterium mit Filtern für Grid Tabellenblätter, den 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");
// 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);

Zurücksenden

Color: Die Vordergrundfarbe, die als Filterkriterium verwendet wird.

`getVisibleValues()`

Gibt die Werte zurück, die im Filter der Pivot-Tabelle angezeigt werden.

Dieses Kriterium gilt nur für Filter in 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);

Zurücksenden

String[]: Ein Array von Werten, die der Filter der Pivot-Tabelle 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 auf Grid-Tabellenblätter verwenden, den Standardtyp von Tabellenblättern.

// 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 Werte, die ausgeblendet werden sollen.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`setVisibleBackgroundColor(visibleBackgroundColor)`

Legt die Hintergrundfarbe als Filterkriterium fest. Zellen mit dieser Hintergrundfarbe sind weiterhin sichtbar. Wenn Sie Hintergrundfarbenfilterkriterien festlegen, werden alle aktuellen Farbfilterkriterien aus diesem Builder entfernt.

Sie können dieses Kriterium nur für Filter auf Grid-Tabellenblätter verwenden, den Standardtyp von Tabellenblättern.

// 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-Format sein. Designfarben werden von dieser Methode nicht unterstützt.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`setVisibleForegroundColor(visibleForegroundColor)`

Legt die Vordergrundfarbe als Filterkriterium fest. Zellen mit dieser Vordergrundfarbe bleiben sichtbar. Wenn Sie ein Farbfilterkriterium für den Vordergrund festlegen, werden alle aktuellen Farbfilterkriterien aus diesem Builder entfernt.

Sie können dieses Kriterium nur für Filter auf Grid-Tabellenblätter verwenden, den Standardtyp von Tabellenblättern.

// 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-Format sein. Designfarben werden von dieser Methode nicht unterstützt.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`setVisibleValues(values)`

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

Sie können dieses Kriterium nur für Filter in 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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenCellEmpty()`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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);

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenCellNotEmpty()`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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);

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenDateAfter(date)`

Legt Filterkriterien fest, bei denen Zellen angezeigt werden, deren Datum nach dem angegebenen Datum liegt.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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 späteste ausgeblendete Datum.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenDateAfter(date)`

Legt Filterkriterien fest, bei denen Zellen angezeigt werden, deren Datum nach dem angegebenen relativen Datum liegt. Informationen zu den relativen Datumsoptionen finden Sie unter Aufzählung 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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenDateBefore(date)`

Legt Filterkriterien fest, bei denen Zellen vor dem angegebenen Datum zu sehen sind.

// 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 zu verbergende Datum.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenDateBefore(date)`

Legt Filterkriterien fest, bei denen Zellen mit Datumsangaben angezeigt werden, die vor dem angegebenen relativen Datum liegen. Informationen zu den relativen Datumsoptionen finden Sie unter Aufzählung 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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenDateEqualTo(date)`

Legt Filterkriterien fest, bei denen Zellen mit dem angegebenen Datum angezeigt werden.

// 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, an dem die Zellenwerte übereinstimmen müssen.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenDateEqualTo(date)`

Legt Filterkriterien fest, bei denen Zellen angezeigt werden, die mit dem angegebenen relativen Datum übereinstimmen. Informationen zu den relativen Datumsoptionen finden Sie unter Aufzählung 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 Zellwerte übereinstimmen müssen.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`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 auf einem DataSource-Tabellenblatt, einem mit einer Datenbank verbundenen Tabellenblatt oder einem DataSourcePivotTable, einer Pivot-Tabelle aus einem DataSource-Tabellenblatt.

// 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 Zeiträume.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenFormulaSatisfied(formula)`

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

Sie können diese Kriterien nur verwenden, um Daten zu filtern, die nicht mit einer Datenbank verknüpft 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` ausgewertet wird, wenn die Eingabe gültig ist.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberBetween(start, end)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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 anzuzeigende Zahl.
`end`	`Number`	Die höchste anzuzeigende Zahl.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberEqualTo(number)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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 anzuzeigende Zahl.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberGreaterThan(number)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberGreaterThanOrEqualTo(number)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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 anzuzeigende Zahl.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberLessThan(number)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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`	Niedrigste Zahl, die ausgeblendet werden soll.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberLessThanOrEqualTo(number)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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 anzuzeigende Zahl.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberNotBetween(start, end)`

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die nicht zwischen 2 angegebenen Zahlen liegen und keine davon ist.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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`	Niedrigste Zahl ausblenden.
`end`	`Number`	Die höchste Zahl, die ausgeblendet werden soll.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenNumberNotEqualTo(number)`

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

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden. 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. Andernfalls können Sie unerwartete Ergebnisse erhalten.

// 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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`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.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextContains(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der den angegebenen Text enthält. Beim Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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`	Der Text, den die Zelle enthalten muss.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextDoesNotContain(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der den angegebenen Text nicht enthält. Beim Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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`	Der Text, den die Zelle nicht enthalten darf.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextEndsWith(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der mit dem angegebenen Text endet. Beim Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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, der am Ende des Textes der Zelle enthalten sein muss.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextEqualTo(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der dem angegebenen Text entspricht. Beim Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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`	Der Text, den der Text in der Zelle enthalten muss.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextEqualToAny(texts)`

Legt die Filterkriterien fest, damit Zellen mit Text angezeigt werden, der einem der angegebenen Textwerte entspricht. Die Groß- und Kleinschreibung wird nicht berücksichtigt.

// 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 enthalten muss.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextNotEqualTo(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der nicht dem angegebenen Text entspricht. Beim Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

// 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`	Der Text in der Zelle, der nicht gleich sein darf.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextNotEqualToAny(texts)`

Legt die Filterkriterien so fest, dass Text in Zellen angezeigt wird, die keinem der angegebenen Werte entsprechen. Die Groß- und Kleinschreibung wird nicht berücksichtigt.

// 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[]`	Die Textwerte, die eine Zelle nicht gleich sein darf.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`whenTextStartsWith(text)`

Legt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der mit dem angegebenen Text beginnt. Beim Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können diese Kriterien mit jedem beliebigen Filtertyp verwenden.

// 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 Textes der Zelle enthalten muss.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.

`withCriteria(criteria, args)`

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

Sie können diese Kriterien mit jedem Filtertyp verwenden. Einige BooleanCriteria sind jedoch nicht auf alle Filter anwendbar.

// 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 von Argumenten, die dem Kriterientyp entsprechen. Die Anzahl der Argumente und ihr Typ stimmen mit den entsprechenden obigen `when...()`-Methoden überein.

Zurücksenden

FilterCriteriaBuilder: Dieser Builder zum Verketten.