Class FilterCriteriaBuilder

Tworzy kryteria filtra na podstawie ustawień dodanych do kreatora kryteriów.

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

Powrót

FilterCriteria – reprezentacja kryteriów filtra.

Kopiuje to kryterium filtra i tworzy kreator kryteriów, który możesz zastosować do innego filtra.

Z tej metody możesz korzystać w przypadku dowolnego typu filtra. Jeśli używasz filtra arkusza, możesz skopiować kryteria do innej kolumny.

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

Powrót

FilterCriteriaBuilder – kreator kryteriów filtra oparty na tych kryteriach.

Zwraca typ logiczny kryterium, np. CELL_EMPTY. Więcej informacji o typach kryteriów logicznych znajdziesz w enumeracji BooleanCriteria.

Użytkownicy często korzystają z tej metody, aby dodać do filtra kryteria warunków logicznych bez zastępowania dotychczasowych kryteriów.

• Aby uzyskać argumenty dla kryteriów, użyj getCriteriaValues().
• Aby utworzyć lub zmodyfikować kryteria filtrowania, korzystając z typu kryteriów i ich wartości, zapoznaj się z artykułem withCriteria(criteria, args).

Możesz używać tej metody w przypadku dowolnego typu filtra. Jeśli kryteria filtra nie są warunkiem logicznym, zwracają wartość null.

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

Powrót

BooleanCriteria – typ kryterium logicznego lub null, jeśli kryterium nie jest warunkiem logicznym.

Zwraca tablicę argumentów dla kryteriów logicznych. Niektóre typy kryteriów logicznych nie mają argumentów i zwracają pusty tablic, np. CELL_NOT_EMPTY.

Użytkownicy często korzystają z tej metody, aby dodać do filtra kryteria warunków logicznych bez zastępowania dotychczasowych kryteriów.

• Aby uzyskać typ kryteriów logicznych, użyj getCriteriaType().
• Aby utworzyć lub zmodyfikować kryterium filtra, korzystając z typu kryterium i jego wartości, zapoznaj się z artykułem withCriteria(criteria, args).

  Możesz używać tej metody w przypadku dowolnego typu filtra.

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

  Powrót

  Object[] – tablica argumentów odpowiednich do typu kryteriów logicznych. Liczba argumentów i ich typ odpowiadają odpowiedniej metodzie when...() klasy FilterCriteriaBuilder.

Zwraca wartości, które filtr ukrywa.

Użyj tego kryterium z filtrami w arkuszach Grid, które są domyślnym typem arkusza. Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

String[] – tablica wartości, które filtr ukrywa.

Zwraca kolor tła użyty jako kryterium filtra. Komórki o tym kolorze tła pozostają widoczne.

Użyj tego kryterium z filtrami w arkuszach Grid, które są domyślnym typem arkusza. Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

Color – kolor tła używany jako kryterium filtrowania.

Zwraca kolor pierwszego planu użyty jako kryterium filtra. Komórki o tym kolorze pierwszego planu pozostają widoczne.

Użyj tego kryterium z filtrami w arkuszach Grid, które są domyślnym typem arkusza. Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

Color – kolor pierwszego planu używany jako kryterium filtrowania.

Zwraca wartości wyświetlane przez filtr tabeli przestawnej.

To kryterium dotyczy tylko filtrów w tabelach przestawnych, które nie są połączone z bazą danych. W przypadku innych typów filtrów zwraca pustą tablicę.

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

Powrót

String[] – tablica wartości wyświetlanych przez filtr tabeli przestawnej.

Określa wartości do ukrycia. Czyści wszystkie istniejące widoczne lub ukryte wartości.

Tego kryterium możesz używać tylko w przypadku filtrów w arkuszach Grid, które są domyślnym typem arkusza.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Rzuty

Error – jeśli jakakolwiek z wartości to null.

Umożliwia ustawienie koloru tła używanego jako kryterium filtra. Komórki o tym kolorze tła pozostają widoczne. Ustawienie kryteriów filtra koloru tła powoduje usunięcie wszystkich bieżących kryteriów filtra koloru z tego kreatora.

Tego kryterium możesz używać tylko w przypadku filtrów w arkuszach Grid, które są domyślnym typem arkusza.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kolor pierwszego planu używany jako kryterium filtra. Komórki o tym kolorze pierwszego planu pozostają widoczne. Ustawienie kryteriów filtra koloru pierwszego planu spowoduje usunięcie wszystkich bieżących kryteriów filtra koloru z tego kreatora.

Tego kryterium możesz używać tylko w przypadku filtrów w arkuszach Grid, które są domyślnym typem arkusza.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia wartości do wyświetlania w tabeli przestawnej. Czyści wszystkie istniejące widoczne lub ukryte wartości.

Tego kryterium możesz używać tylko w przypadku filtrów w tabelach przestawnych, które nie są połączone z bazą danych.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Rzuty

Error – jeśli jakakolwiek z wartości to null.

Ustawia kryteria filtra tak, aby wyświetlały puste komórki.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są puste.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, które powodują wyświetlanie komórek z datami po wybranej dacie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typem daty. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, które pokazują komórki z datami po wybranej dacie względnej. Opcje daty względnej znajdziesz w sekcji Enum RelativeDate.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typem daty. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, które pokazują komórki z datami wcześniejszymi niż wybrana data.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typem daty. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, które powodują wyświetlanie komórek z datami poprzedzającymi wybraną datę względną. Opcje daty względnej znajdziesz w enumeracji RelativeDate.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typem daty. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, które wyświetlają komórki z datami równymi podanej dacie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typem daty. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, które pokazują komórki z datami równymi podanej względnej dacie. Opcje daty względnej znajdziesz w enumeracji RelativeDate.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typem daty. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z datami równymi dowolnej z podanych dat.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlić komórki, które nie są równe podanej dacie.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

Typ danych kolumny, według której filtrujesz, musi być datą.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra tak, aby wyświetlały komórki z datami, które nie są równe żadnej z określonych dat.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra tak, aby wyświetlać komórki z określoną formułą (np. =B:B<C:C), która zwraca wartość true.

Tego kryterium możesz używać tylko do filtrowania danych, które nie są połączone z bazą danych.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która mieści się między 2 określonymi liczbami lub jest jedną z tych liczb.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą równą podanej liczbie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą równą dowolnej z określonych liczb.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą większą niż określona liczba

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą większą lub równą określonej liczbie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą niż określona.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą lub równą określonej liczbie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą, która nie mieści się w zakresie 2 określonych liczb.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która nie jest równa określonej liczbie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która nie jest równa żadnej z określonych liczb.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem zawierającym określony tekst. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtrowania w taki sposób, aby wyświetlać komórki z tekstem, który nie zawiera określonego tekstu. Wielkość liter w tekście nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem równym podanemu tekstowi. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem równym dowolnej z określonych wartości tekstowych. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który nie jest równy podanemu tekstowi. Wielkość liter w tekście nie ma znaczenia.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra tak, aby wyświetlać komórki z tekstem, który nie jest równy żadnej z określonych wartości. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który zaczyna się od określonego tekstu. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Ustawia kryteria filtrowania na warunek logiczny zdefiniowany za pomocą wartości BooleanCriteria, takich jak CELL_EMPTY lub NUMBER_GREATER_THAN. Aby skopiować warunek logiczny z dotychczasowych kryteriów, zdefiniuj parametry tej metody za pomocą elementów getCriteriaType() i getCriteriaValues() w dotychczasowych kryteriach.

Tego kryterium możesz używać z dowolnym typem filtra, ale niektóre BooleanCriteria nie są stosowane do wszystkich filtrów.

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

Parametry

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.