Class FilterCriteriaBuilder

Stellt die Filterkriterien anhand der Einstellungen zusammen, die Sie dem Tool zur Bedingungserstellung hinzufügen.

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

Rückflug

FilterCriteria: Eine Darstellung der Filterkriterien.

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

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

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
const 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 zum Erstellen von Filterkriterien basierend auf diesem Filterkriterium.

Gibt den booleschen Typ des Kriteriums zurück, z. B. CELL_EMPTY. Informationen zu den verschiedenen Arten von booleschen Kriterien finden Sie im BooleanCriteria-Enum.

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

• Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen.
• Informationen zum Erstellen oder Ändern von Filterkriterien mit dem Kriterientyp und den Kriterienwerten finden Sie unter withCriteria(criteria, args).

Sie können diese Methode für jeden Filtertyp verwenden. Wenn die Filterkriterien keine boolesche Bedingung sind, wird null zurückgegeben.

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

Rückflug

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

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.

• Verwenden Sie getCriteriaType(), um den booleschen Kriterientyp abzurufen.
• Informationen zum Erstellen oder Ändern von Filterkriterien mit dem Kriterientyp und den Kriterienwerten finden Sie unter withCriteria(criteria, args).

  Sie können diese Methode für jeden Filtertyp verwenden.

  const ss = SpreadsheetApp.getActiveSheet();
  const 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.
  const 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 stimmen mit der entsprechenden when...()-Methode der FilterCriteriaBuilder-Klasse überein.

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

Verwenden Sie dieses Kriterium mit Filtern in Grid-Tabellen, dem Standardtyp von Tabellen. Gibt null zurück, wenn Sie diese Methode für andere Filtertypen aufrufen.

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

Rückflug

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

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

Verwenden Sie dieses Kriterium mit Filtern in Grid-Tabellen, dem Standardtyp von Tabellen. Gibt null zurück, wenn Sie diese Methode für andere Filtertypen aufrufen.

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

Rückflug

Color|null: Die Hintergrundfarbe, die als Filterkriterium verwendet wird.

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

Verwenden Sie dieses Kriterium mit Filtern in Grid-Tabellen, dem Standardtyp von Tabellen. Gibt null zurück, wenn Sie diese Methode für andere Filtertypen aufrufen.

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

Rückflug

Color|null: Die Vordergrundfarbe, die als Filterkriterium verwendet wird.

Gibt die Werte zurück, die im Pivot-Tabellenfilter angezeigt werden.

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

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

Rückflug

String[]: Ein Array von Werten, die im Pivot-Tabellenfilter angezeigt werden.

Legt die auszublendenden Werte fest. Löscht alle vorhandenen sichtbaren oder verborgenen Werte.

Sie können dieses Kriterium nur für Filter in Grid-Tabellen verwenden, dem Standardtyp von Tabellen.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Löst

Error: Wenn einer der Werte null ist.

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

Sie können dieses Kriterium nur für Filter in Grid-Tabellen verwenden, dem Standardtyp von Tabellen.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

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

Sie können dieses Kriterium nur für Filter in Grid-Tabellen verwenden, dem Standardtyp von Tabellen.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Werte fest, die in einer Pivot-Tabelle angezeigt werden sollen. Löscht alle vorhandenen sichtbaren oder verborgenen 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."
const pivotTable = ss.getPivotTables()[0];
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setVisibleValues(['Northeast', 'Southwest'])
                     .build();
pivotTable.addFilter(2, criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Löst

Error: Wenn einer der Werte null ist.

Legt die Filterkriterien fest, um leere Zellen anzuzeigen.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen anzuzeigen, die nicht leer sind.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt Filterkriterien fest, mit denen Zellen mit Datumsangaben angezeigt werden, die nach dem angegebenen Datum liegen.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, kann es zu unerwarteten Ergebnissen kommen.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt Filterkriterien fest, mit denen Zellen mit Datumsangaben angezeigt werden, die nach dem angegebenen relativen Datum liegen. Informationen zu den Optionen für relative Datumsangaben finden Sie unter Enum RelativeDate.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, kann es zu unerwarteten Ergebnissen kommen.

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

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt Filterkriterien fest, mit denen Zellen mit Datumsangaben angezeigt werden, die vor dem angegebenen Datum liegen.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, kann es zu unerwarteten Ergebnissen kommen.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt Filterkriterien fest, mit denen Zellen mit Datumsangaben angezeigt werden, die vor dem angegebenen relativen Datum liegen. Informationen zu den Optionen für relative Datumsangaben finden Sie unter Enum RelativeDate.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, kann es zu unerwarteten Ergebnissen kommen.

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

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt Filterkriterien fest, mit denen Zellen mit Datumsangaben angezeigt werden, die dem angegebenen Datum entsprechen.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, kann es zu unerwarteten Ergebnissen kommen.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt Filterkriterien fest, mit denen Zellen mit Datumsangaben angezeigt werden, die dem angegebenen relativen Datum entsprechen. Informationen zu den Optionen für relative Datumsangaben finden Sie unter Enum RelativeDate.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, kann es zu unerwarteten Ergebnissen kommen.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

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

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen anzuzeigen, die nicht dem angegebenen Datum entsprechen.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer 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.
const ss =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Pivot Table Sheet');
const dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
const date = new Date('June 16, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateNotEqualTo(date).build();
dataPivotTable.addFilter('date', criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien so fest, dass Zellen mit Datumsangaben angezeigt werden, die nicht mit den angegebenen Datumsangaben übereinstimmen.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer bestimmten Formel (z. B. =B:B<C:C) anzuzeigen, die zu true ausgewertet wird.

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

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const 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.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die zwischen zwei angegebenen Zahlen liegt oder eine der beiden Zahlen ist.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die der angegebenen Zahl entspricht.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die einer der angegebenen Zahlen entspricht.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl größer als die angegebene Zahl anzuzeigen.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl größer oder gleich der angegebenen Zahl anzuzeigen.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die kleiner als die angegebene Zahl ist.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl kleiner oder gleich der angegebenen Zahl anzuzeigen.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die nicht zwischen zwei angegebenen Zahlen liegt und auch nicht eine der beiden Zahlen ist.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die nicht der angegebenen Zahl entspricht.

Sie können dieses Kriterium mit jedem 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. Wenn er es jedoch nicht ist, erhalten Sie möglicherweise unerwartete Ergebnisse.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit einer Zahl anzuzeigen, die keiner der angegebenen Zahlen entspricht.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der den angegebenen Text enthält. Bei dem Text wird die Groß- und Kleinschreibung nicht berücksichtigt.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der den angegebenen Text nicht enthält. Bei dem Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der mit dem angegebenen Text endet. Bei dem Text wird die Groß- und Kleinschreibung nicht berücksichtigt.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der dem angegebenen Text entspricht. Bei dem Text wird die Groß- und Kleinschreibung nicht berücksichtigt.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der einem der angegebenen Textwerte entspricht. Bei dem Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der nicht dem angegebenen Text entspricht. Bei dem Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der nicht mit einem der angegebenen Werte übereinstimmt. Bei dem Text wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Sie können dieses Kriterium nur mit Daten verwenden, die mit einer Datenbank verbunden sind. Sie können diese Kriterien beispielsweise mit Filtern in einem DataSource-Tabellenblatt, einem Tabellenblatt, das mit einer Datenbank verbunden ist, oder einer DataSourcePivotTable verwenden, einer Pivot-Tabelle, die aus einem DataSource-Tabellenblatt erstellt wurde.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

Legt die Filterkriterien fest, um Zellen mit Text anzuzeigen, der mit dem angegebenen Text beginnt. Bei dem Text wird die Groß- und Kleinschreibung nicht berücksichtigt.

Sie können dieses Kriterium mit jedem Filtertyp verwenden.

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

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.

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 vorhandene Kriterien.

Sie können dieses Kriterium mit jedem Filtertyp verwenden. Einige BooleanCriteria sind jedoch nicht für 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();
const 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."
const filterCriteria = filter.getColumnFilterCriteria(2);
const criteria = SpreadsheetApp.newFilterCriteria()
                     .withCriteria(
                         filterCriteria.getCriteriaType(),
                         filterCriteria.getCriteriaValues(),
                         )
                     .setHiddenValues(['Northwest'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

Parameter

Rückflug

FilterCriteriaBuilder – Dieser Builder zur Verkettung.