Class FilterCriteriaBuilder

FilterCriteriaBuilder

So fügen Sie einem Filter Kriterien hinzu:

  1. Erstellen Sie das Tool zur Kriterienerstellung mit SpreadsheetApp.newFilterCriteria().
  2. Fügen Sie dem Builder mithilfe der Methoden aus dieser Klasse Einstellungen hinzu.
  3. Verwenden Sie build(), um die Kriterien mit Ihren angegebenen Einstellungen zusammenzustellen.

Übliche Anwendungsbereiche

Werte in einem Tabellenblatt ausblenden

Im folgenden Beispiel wird der vorhandene Filter einer Tabelle abgerufen und es werden Kriterien hinzugefügt, durch die die Zellen in Spalte C, die „hello“ enthält oder "Welt". Die Kriterien in diesem Beispiel können nur mit Filter für Grid Tabellenblätter – der Standardtabellentyp.
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 ein Filter hinzugefügt, die mit einer Datenbank verbunden sind, wobei das Kriterium nur die Zellen in der "Kategorie" anzeigt Spalte 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

MethodeRückgabetypKurzbeschreibung
build()FilterCriteriaStellt die Filterkriterien anhand der Einstellungen zusammen, die Sie der Kriterienerstellung hinzufügen.
copy()FilterCriteriaBuilderKopiert dieses Filterkriterium und erstellt eine Kriterienerstellung, die Sie auf ein anderes anwenden können aus.
getCriteriaType()BooleanCriteriaGibt 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 durch den Filter ausgeblendet werden.
getVisibleBackgroundColor()ColorGibt die Hintergrundfarbe zurück, die als Filterkriterium verwendet wird.
getVisibleForegroundColor()ColorGibt die Vordergrundfarbe zurück, die als Filterkriterium verwendet wird
getVisibleValues()String[]Gibt die Werte zurück, die im Filter für Pivot-Tabellen angezeigt werden.
setHiddenValues(values)FilterCriteriaBuilderLegt die Werte fest, die ausgeblendet werden sollen.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderLegt die Hintergrundfarbe fest, die als Filterkriterien verwendet wird.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderLegt die Vordergrundfarbe fest, die als Filterkriterium verwendet wird
setVisibleValues(values)FilterCriteriaBuilderLegt die Werte fest, die in einer Pivot-Tabelle angezeigt werden sollen.
whenCellEmpty()FilterCriteriaBuilderLegt die Filterkriterien so fest, dass leere Zellen angezeigt werden.
whenCellNotEmpty()FilterCriteriaBuilderLegt die Filterkriterien so fest, dass nicht leere Zellen angezeigt werden.
whenDateAfter(date)FilterCriteriaBuilderLegt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Daten nach dem angegebenen Datum liegen.
whenDateAfter(date)FilterCriteriaBuilderLegt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben nach dem angegebenen relativen Datum liegen.
whenDateBefore(date)FilterCriteriaBuilderLegt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Daten vor dem angegebenen Datum liegen.
whenDateBefore(date)FilterCriteriaBuilderLegt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben vor dem angegebenen relativen Datum liegen.
whenDateEqualTo(date)FilterCriteriaBuilderLegt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben mit dem angegebenen Datum übereinstimmen.
whenDateEqualTo(date)FilterCriteriaBuilderLegt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben mit dem angegebenen relativen Datum übereinstimmen.
whenDateEqualToAny(dates)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Datumsangaben mit einem beliebigen der angegebenen Daten übereinstimmen.
whenDateNotEqualTo(date)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, die nicht dem angegebenen Datum entsprechen.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Datumsangaben nicht mit einem der angegebenen übereinstimmen Daten.
whenFormulaSatisfied(formula)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit einer bestimmten Formel (z. B. =B:B<C:C) angezeigt werden, die ergibt true.
whenNumberBetween(start, end)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die zwischen 2 oder 2 liegt angegebenen Zahlen.
whenNumberEqualTo(number)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl enthalten, die der angegebenen Zahl entspricht.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die einem der angegebenen Werte entspricht Zahlen.
whenNumberGreaterThan(number)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl größer als die angegebene Zahl enthalten
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl größer oder gleich dem angegebenen Wert enthalten Nummer.
whenNumberLessThan(number)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Zahl kleiner als die angegebene Zahl ist.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl kleiner oder gleich der angegebenen Zahl enthalten Nummer.
whenNumberNotBetween(start, end)FilterCriteriaBuilderLegt das Filterkriterium so fest, dass Zellen angezeigt werden, in denen eine Zahl nicht zwischen diesen liegt und nicht 2 ist angegebenen Zahlen.
whenNumberNotEqualTo(number)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Zahl nicht der angegebenen Zahl entspricht.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die keinem der angegebenen entspricht Zahlen.
whenTextContains(text)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text den angegebenen Text enthält.
whenTextDoesNotContain(text)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text den angegebenen Text nicht enthält.
whenTextEndsWith(text)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text endet.
whenTextEqualTo(text)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der dem angegebenen Text entspricht.
whenTextEqualToAny(texts)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der einem beliebigen angegebenen Text entspricht Werte.
whenTextNotEqualTo(text)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der nicht dem angegebenen Text entspricht.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen mit Text angezeigt werden, der keinem der angegebenen Textelemente entspricht Werte.
whenTextStartsWith(text)FilterCriteriaBuilderLegt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text beginnt.
withCriteria(criteria, args)FilterCriteriaBuilderLegt die Filterkriterien auf eine durch BooleanCriteria-Werte definierte boolesche Bedingung fest, z. B. als CELL_EMPTY oder NUMBER_GREATER_THAN.

Detaillierte Dokumentation

build()

Stellt die Filterkriterien anhand der Einstellungen zusammen, die Sie der 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);

Rückflug

FilterCriteria: Darstellung der Filterkriterien.


copy()

Kopiert dieses Filterkriterium und erstellt eine Kriterienerstellung, die Sie auf ein anderes anwenden können aus.

Sie können diese Methode mit jeder Art von Filter verwenden. Wenn Sie einen Tabellenblattfilter verwenden, kopieren Sie die Kriterien in eine andere Spalte.

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

Rückflug

FilterCriteriaBuilder: Ein Tool zur Erstellung von Filterkriterien, der auf diesen Filterkriterien basiert.


getCriteriaType()

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

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

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

Sie können diese Methode für jeden Filtertyp verwenden. Wenn das Filterkriterium kein boolescher Wert ist Bedingung verwendet wird, 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);

Rückflug

BooleanCriteria: Der Typ des booleschen Kriteriums oder null, wenn das Kriterium kein boolescher Wert ist .


getCriteriaValues()

Gibt ein Array von Argumenten für boolesche Kriterien zurück. Einige boolesche Kriterientypen enthalten keine 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 sie zu ersetzen bereits bestehenden Kriterien.

  • Verwenden Sie getCriteriaType(), um den booleschen Kriterientyp abzurufen.
  • Informationen zur Verwendung des Kriterientyps und der Kriterienwerte zum Erstellen oder Ändern von Filterkriterien finden Sie unter withCriteria(criteria, args)

    Sie können diese Methode für jeden Filtertyp 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);

    Rückflug

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


getHiddenValues()

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

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

Rückflug

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


getVisibleBackgroundColor()

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

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

Rückflug

Color: Die als Filterkriterien verwendete Hintergrundfarbe.


getVisibleForegroundColor()

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

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

Rückflug

Color: Die als Filterkriterium verwendete Vordergrundfarbe.


getVisibleValues()

Gibt die Werte zurück, die im Filter für Pivot-Tabellen 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);

Rückflug

String[]: Ein Array von Werten, die der Filter für die 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 in Grid Tabellenblatt verwenden (Standardeinstellung) Tabellenblatttyp.

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

NameTypBeschreibung
valuesString[]Die Liste der auszublendenden Werte.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

Löst aus

Error: wenn einer der Werte null ist.


setVisibleBackgroundColor(visibleBackgroundColor)

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

Sie können dieses Kriterium nur für Filter in Grid Tabellenblatt verwenden (Standardeinstellung) Tabellenblatttyp.

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

NameTypBeschreibung
visibleBackgroundColorColorDie festzulegende Hintergrundfarbe. Die Farbe muss ein RGB-Stil sein Farbe. Bei dieser Methode werden keine Designfarben unterstützt.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


setVisibleForegroundColor(visibleForegroundColor)

Legt die Vordergrundfarbe fest, die als Filterkriterium verwendet wird Zellen mit dieser Vordergrundfarbe bleiben sichtbar sind. Wenn Sie ein Vordergrundfarbfilterkriterium festlegen, werden alle aktuellen Farbfilterkriterien entfernt. von diesem Builder.

Sie können dieses Kriterium nur für Filter in Grid Tabellenblatt verwenden (Standardeinstellung) Tabellenblatttyp.

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

NameTypBeschreibung
visibleForegroundColorColorDie festzulegende Vordergrundfarbe. Die Farbe muss ein RGB-Stil sein Farbe. Bei dieser Methode werden keine Designfarben unterstützt.

Rückflug

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 einem Datenbank.

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

NameTypBeschreibung
valuesString[]Die Liste der anzuzeigenden Werte.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.

Löst aus

Error: wenn einer der Werte null ist.


whenCellEmpty()

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

Sie können dieses Kriterium mit jeder Art von Filter 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);

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenCellNotEmpty()

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

Sie können dieses Kriterium mit jeder Art von Filter 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);

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateAfter(date)

Legt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Daten nach dem angegebenen Datum liegen.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn der Parameter Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht muss es sich um ein Datum handeln. Ist dies 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

NameTypBeschreibung
dateDateDas letzte Datum, das ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateAfter(date)

Legt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben nach dem angegebenen relativen Datum liegen. Bis Die relativen Datumsoptionen finden Sie unter Enum RelativeDate.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn der Parameter Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht muss es sich um ein Datum handeln. Ist dies 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 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

NameTypBeschreibung
dateRelativeDateDas letzte relative Datum.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateBefore(date)

Legt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Daten vor dem angegebenen Datum liegen.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn der Parameter Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht muss es sich um ein Datum handeln. Ist dies 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 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

NameTypBeschreibung
dateDateDas früheste Datum, das ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateBefore(date)

Legt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben vor dem angegebenen relativen Datum liegen. Informationen zu den relativen Datumsoptionen finden Sie unter Enum RelativeDate.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn der Parameter Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht muss es sich um ein Datum handeln. Ist dies 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 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

NameTypBeschreibung
dateRelativeDateDas früheste relative Datum, das ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateEqualTo(date)

Legt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben mit dem angegebenen Datum übereinstimmen.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn der Parameter Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht muss es sich um ein Datum handeln. Ist dies 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 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

NameTypBeschreibung
dateDateDas Datum, mit dem die Zellenwerte übereinstimmen müssen.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateEqualTo(date)

Legt Filterkriterien fest, nach denen Zellen angezeigt werden, deren Datumsangaben mit dem angegebenen relativen Datum übereinstimmen. Informationen zu den relativen Datumsoptionen finden Sie unter Enum RelativeDate.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, ein Datum sein. Wenn der Parameter Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht muss es sich um ein Datum handeln. Ist dies 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 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

NameTypBeschreibung
dateRelativeDateDas relative Datum, mit dem die Zellenwerte übereinstimmen müssen.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateEqualToAny(dates)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Datumsangaben mit einem beliebigen der angegebenen Daten übereinstimmen.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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

NameTypBeschreibung
datesDate[]Die anzuzeigenden Daten.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateNotEqualTo(date)

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

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder DataSourcePivotTable, eine Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

NameTypBeschreibung
dateDateDas Datum, das ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenDateNotEqualToAny(dates)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Datumsangaben nicht mit einem der angegebenen übereinstimmen Daten.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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 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

NameTypBeschreibung
datesDate[]Die Daten, die ausgeblendet werden sollen.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenFormulaSatisfied(formula)

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

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

NameTypBeschreibung
formulaStringEine benutzerdefinierte Formel, die true ergibt, wenn die Eingabe gültig ist.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberBetween(start, end)

Legt die Filterkriterien so fest, dass Zellen mit einer Zahl angezeigt werden, die zwischen 2 oder 2 liegt angegebenen Zahlen.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
startNumberDie niedrigste Zahl, die angezeigt werden soll.
endNumberDie höchste Zahl, die angezeigt werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberEqualTo(number)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl enthalten, die der angegebenen Zahl entspricht.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
numberNumberDie Nummer, die angezeigt werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberEqualToAny(numbers)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Zahl mindestens einem der angegebenen entspricht Zahlen.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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 "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

NameTypBeschreibung
numbersNumber[]Die anzuzeigenden Zahlen.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberGreaterThan(number)

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

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
numberNumberDie höchste Zahl, die ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberGreaterThanOrEqualTo(number)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl größer oder gleich dem angegebenen Wert enthalten Nummer.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
numberNumberDie niedrigste Zahl, die angezeigt werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberLessThan(number)

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

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
numberNumberDie niedrigste Zahl, die ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberLessThanOrEqualTo(number)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, die eine Zahl kleiner oder gleich der angegebenen Zahl enthalten Nummer.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
numberNumberDie höchste Zahl, die angezeigt werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberNotBetween(start, end)

Legt das Filterkriterium so fest, dass Zellen angezeigt werden, in denen eine Zahl nicht zwischen diesen liegt und nicht 2 ist angegebenen Zahlen.

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
startNumberDie niedrigste Zahl wird ausgeblendet.
endNumberDie höchste Zahl, die ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberNotEqualTo(number)

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

Sie können dieses Kriterium mit jeder Art von Filter verwenden. Wenn Sie dieses Kriterium mit Daten verwenden, mit einer Datenbank verbunden ist, muss der Datentyp der Spalte, nach der Sie filtern, eine Zahl sein. Wenn Wenn die Daten nicht mit einer Datenbank verbunden sind, wird der Datentyp der Spalte, nach der Sie filtern, nicht müssen Sie eine Zahl sein. Andernfalls 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

NameTypBeschreibung
numberNumberDie Zahl, die ausgeblendet werden soll.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenNumberNotEqualToAny(numbers)

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

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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 "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

NameTypBeschreibung
numbersNumber[]Die Zahlen, die ausgeblendet werden sollen.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextContains(text)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text den angegebenen Text enthält. Der Text nicht zwischen Groß- und Kleinschreibung.

Sie können dieses Kriterium mit jeder Art von Filter 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

NameTypBeschreibung
textStringDer Text, den die Zelle enthalten muss.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextDoesNotContain(text)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text den angegebenen Text nicht enthält. Die Groß- und Kleinschreibung nicht berücksichtigt wird.

Sie können dieses Kriterium mit jeder Art von Filter 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

NameTypBeschreibung
textStringDer Text, den die Zelle nicht enthalten darf.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextEndsWith(text)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text endet. Der Text nicht zwischen Groß- und Kleinschreibung.

Sie können dieses Kriterium mit jeder Art von Filter 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

NameTypBeschreibung
textStringText, den das Ende des Zellentexts enthalten muss.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextEqualTo(text)

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

Sie können dieses Kriterium mit jeder Art von Filter 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

NameTypBeschreibung
textStringDer Text, mit dem der Text der Zelle identisch sein muss.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextEqualToAny(texts)

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

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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 "category" column that shows cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

NameTypBeschreibung
textsString[]Die Textwerte, denen eine Zelle entsprechen muss.

Rückflug

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 nicht berücksichtigt wird.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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 "category" column that hides cells with text equal to "tech."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualTo("tech")
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

NameTypBeschreibung
textStringDer Text, mit dem sich der Text der Zelle unterscheiden kann.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextNotEqualToAny(texts)

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

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verknüpft sind. Verwenden Sie zum Beispiel diese Kriterien mit Filtern auf einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit Datenbank oder 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 "category" column that hides cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

NameTypBeschreibung
textsString[]Die Textwerte, denen eine Zelle nicht entsprechen kann.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


whenTextStartsWith(text)

Legt die Filterkriterien so fest, dass Zellen angezeigt werden, deren Text mit dem angegebenen Text beginnt. Der Text nicht zwischen Groß- und Kleinschreibung.

Sie können dieses Kriterium mit jeder Art von Filter 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

NameTypBeschreibung
textStringText, den der Anfang des Zellentexts enthalten muss.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.


withCriteria(criteria, args)

Legt die Filterkriterien auf eine durch BooleanCriteria-Werte definierte boolesche Bedingung fest, z. B. als CELL_EMPTY oder NUMBER_GREATER_THAN. Um die boolesche Bedingung aus Kriterien vorhanden sind, definieren Sie die Parameter für diese Methode mithilfe von getCriteriaType() und getCriteriaValues() vorhandenen Kriterien.

Sie können dieses Kriterium mit jedem Filtertyp verwenden, einige BooleanCriteria jedoch nicht gelten 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

NameTypBeschreibung
criteriaBooleanCriteriaDer Typ der booleschen Kriterien.
argsObject[]Ein Array von Argumenten, die dem Kriterientyp entsprechen. die Anzahl der Argumente und ihr Typ den entsprechenden when...()-Methoden oben entspricht.

Rückflug

FilterCriteriaBuilder: Dieser Builder für Verkettungen.