Ta strona została przetłumaczona przez Cloud Translation API.

Class FilterCriteriaBuilder

Aby dodać kryteria do filtra:

Utwórz kreator kryteriów za pomocą właściwości SpreadsheetApp.newFilterCriteria().
Dodaj ustawienia do kreatora, korzystając z metod z tej klasy.
Użyj narzędzia build(), aby połączyć kryteria z wybranymi ustawieniami.

Typowe zastosowania

Ukrywanie wartości w arkuszu

Poniższy przykład pobiera istniejący filtr arkusza i dodaje kryteria ukrywające komórki w kolumnę C z wyrażeniem „hello” czy „świat”. Kryteria z tej próbki mogą być używane tylko z filtry (domyślny typ arkusza) w arkuszu Grid.

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

Pokazuj tylko niepuste komórki

Poniższy przykład zawiera filtr do arkusza DataSource, czyli arkusza, który połączone z bazą danych z kryteriami, które powodują wyświetlanie tylko komórek w kategorii „Kategoria” kolumna które nie są puste.

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

Metody

Metoda	Zwracany typ	Krótki opis
`build()`	`FilterCriteria`	Łączy kryteria filtrowania, używając ustawień dodanych przez Ciebie do Kreatora kryteriów.
`copy()`	`FilterCriteriaBuilder`	Skopiowanie kryteriów filtra i utworzenie kreatora kryteriów, które można zastosować do innego filtr.
`getCriteriaType()`	`BooleanCriteria`	Zwraca typ wartości logicznej kryterium, na przykład `CELL_EMPTY`.
`getCriteriaValues()`	`Object[]`	Zwraca tablicę argumentów dla kryteriów wartości logicznych.
`getHiddenValues()`	`String[]`	Zwraca wartości ukrywane przez filtr.
`getVisibleBackgroundColor()`	`Color`	Zwraca kolor tła używany jako kryteria filtra.
`getVisibleForegroundColor()`	`Color`	Zwraca kolor pierwszego planu używany jako kryterium filtra.
`getVisibleValues()`	`String[]`	Zwraca wartości wyświetlane przez filtr tabeli przestawnej.
`setHiddenValues(values)`	`FilterCriteriaBuilder`	Ustawia wartości do ukrycia.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	Określa kolor tła używany jako kryteria filtra.
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	Ustawia kolor pierwszego planu używany jako kryteria filtra.
`setVisibleValues(values)`	`FilterCriteriaBuilder`	Ustawia wartości, które mają być wyświetlane w tabeli przestawnej.
`whenCellEmpty()`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki.
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki, które nie są puste.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z datami przypadającymi po określonej dacie.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami przypadającymi po określonej dacie względnej.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z datami sprzed określonej daty.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami, które przypadają przed określoną datą względną.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z datami odpowiadającymi określonej dacie.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami odpowiadającymi określonej dacie względnej.
`whenDateEqualToAny(dates)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z datami, które są równe dowolnej z podanych dat.
`whenDateNotEqualTo(date)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są zgodne z określoną datą.
`whenDateNotEqualToAny(dates)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać komórki z datami, które nie są równe żadnej z podanych wartości daty.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z określoną formułą (np. `=B:B<C:C`), która zwraca wartość `true`.
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki zawierające liczbę mieszczącą się między 2 lub jedną z tych wartości określonych liczb.
`whenNumberEqualTo(number)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki z liczbą równą określonej liczbie.
`whenNumberEqualToAny(numbers)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać komórki z liczbą równą dowolnej z podanych wartości liczby.
`whenNumberGreaterThan(number)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki o liczbie większej niż określona
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać komórki o liczbie równej określonemu lub większej od podanej numer.
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	Ustawia kryteria filtra, aby wyświetlały się komórki z liczbą mniejszą od określonej wartości.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, by wyświetlać komórki o liczbie mniejszej niż określona numer.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	Ustawia kryteria filtra, aby wyświetlały komórki z liczbą, która nie mieści się między określonych liczb.
`whenNumberNotEqualTo(number)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlały komórki z liczbą, która nie jest równa określonej liczbie.
`whenNumberNotEqualToAny(numbers)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą, która nie jest równa żadnej z podanych wartości liczby.
`whenTextContains(text)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem zawierającym określony tekst.
`whenTextDoesNotContain(text)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie zawiera określonego tekstu.
`whenTextEndsWith(text)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem.
`whenTextEqualTo(text)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który jest równy określonemu tekstowi.
`whenTextEqualToAny(texts)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który jest równy dowolnemu z podanych tekstów .
`whenTextNotEqualTo(text)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który różni się od podanego tekstu.
`whenTextNotEqualToAny(texts)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie jest równy żadnej z podanych wartości .
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem rozpoczynającym się od określonego tekstu.
`withCriteria(criteria, args)`	`FilterCriteriaBuilder`	Ustawia kryteria filtra na warunek logiczny zdefiniowany przez wartości `BooleanCriteria`, np. jako `CELL_EMPTY` lub `NUMBER_GREATER_THAN`.

Szczegółowa dokumentacja

`build()`

Łączy kryteria filtrowania, używając ustawień dodanych przez Ciebie do Kreatora kryteriów.

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

Powrót

FilterCriteria – reprezentuje kryteria filtrowania.

`copy()`

Skopiowanie kryteriów filtra i utworzenie kreatora kryteriów, które można zastosować do innego filtr.

Tej metody możesz używać z każdym typem filtra. Jeśli używasz filtra arkusza, możesz skopiować kryteria do innej kolumny.

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

Powrót

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

`getCriteriaType()`

Zwraca typ wartości logicznej kryterium, na przykład CELL_EMPTY. Więcej informacji o typach kryteriów wartości logicznych, zobacz wyliczenie BooleanCriteria.

Użytkownicy często korzystają z tej metody do dodawania do filtra kryteriów warunku logicznego bez zastępowania istniejących kryteriów.

Aby uzyskać argumenty kryteriów, użyj funkcji getCriteriaValues().
Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtrowania, zapoznaj się z artykułem withCriteria(criteria, args)

Możesz użyć tej metody w przypadku każdego typu filtra. Jeśli kryteria filtrowania nie są wartościami logicznymi warunku, zwraca null.

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

Powrót

BooleanCriteria – typ kryteriów wartości logicznej lub null, jeśli nie są one wartościami logicznymi. .

`getCriteriaValues()`

Zwraca tablicę argumentów dla kryteriów wartości logicznych. Niektóre typy kryteriów wartości logicznych nie mają i zwraca pustą tablicę, np. CELL_NOT_EMPTY.

Użytkownicy często korzystają z tej metody do dodawania do filtra kryteriów warunku logicznego bez zastępowania istniejących kryteriów.

Aby uzyskać typ kryteriów wartości logicznej, użyj getCriteriaType().
Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtrowania, zapoznaj się z artykułem withCriteria(criteria, args)
Możesz użyć tej metody w przypadku każdego typu filtra.
```
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);
```
Powrót

Object[] – tablica argumentów odpowiednich dla typu kryteriów wartości logicznych. Liczba argumentów i ich typ pasują do odpowiedniej metody when...() klasy FilterCriteriaBuilder.

`getHiddenValues()`

Zwraca wartości ukrywane przez filtr.

Użyj tych kryteriów w przypadku filtrów w Grid arkuszach (domyślny typ arkusza). Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

String[] – tablica wartości ukrywanych przez filtr.

`getVisibleBackgroundColor()`

Zwraca kolor tła używany jako kryteria filtra. Komórki z tym kolorem tła pozostaną widoczne.

Użyj tych kryteriów w przypadku filtrów w Grid arkuszach (domyślny typ arkusza). Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

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

`getVisibleForegroundColor()`

Zwraca kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem pierwszego planu pozostaną widoczne.

Użyj tych kryteriów w przypadku filtrów w Grid arkuszach (domyślny typ arkusza). Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

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

`getVisibleValues()`

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. Zwraca pustą tablicę w przypadku innych typów filtrów.

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

Powrót

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

`setHiddenValues(values)`

Ustawia wartości do ukrycia. Usuwa wszystkie widoczne i ukryte wartości.

Tych kryteriów możesz użyć tylko w przypadku filtrów w Grid arkuszach (domyślnie typu arkusza.

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

Parametry

Nazwa	Typ	Opis
`values`	`String[]`	Lista wartości do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`setVisibleBackgroundColor(visibleBackgroundColor)`

Określa kolor tła używany jako kryteria filtra. Komórki z tym kolorem tła pozostaną widoczne. Ustawienie kryteriów filtrowania koloru tła usuwa wszystkie bieżące kryteria filtrowania kolorów z tego kreatora.

Tych kryteriów możesz użyć tylko w przypadku filtrów w Grid arkuszach (domyślnie typu arkusza.

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

Parametry

Nazwa	Typ	Opis
`visibleBackgroundColor`	`Color`	Kolor tła do ustawienia. Kolor musi być w stylu RGB koloru. Ta metoda nie obsługuje kolorów motywu.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`setVisibleForegroundColor(visibleForegroundColor)`

Ustawia kolor pierwszego planu używany jako kryteria filtra. Komórki z tym kolorem pierwszego planu pozostaną widoczne. Ustawienie kryteriów filtrowania koloru pierwszego planu powoduje usunięcie wszystkich bieżących kryteriów filtrowania kolorów z tego kreatora.

Tych kryteriów możesz użyć tylko w przypadku filtrów w Grid arkuszach (domyślnie typu arkusza.

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

Parametry

Nazwa	Typ	Opis
`visibleForegroundColor`	`Color`	Kolor pierwszego planu do ustawienia. Kolor musi być w stylu RGB koloru. Ta metoda nie obsługuje kolorów motywu.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`setVisibleValues(values)`

Ustawia wartości, które mają być wyświetlane w tabeli przestawnej. Usuwa wszystkie widoczne i ukryte wartości.

Tego kryterium możesz używać tylko w przypadku filtrów w tabelach przestawnych, które nie są połączone z w bazie 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."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

Parametry

Nazwa	Typ	Opis
`values`	`String[]`	Lista wartości do wyświetlenia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenCellEmpty()`

Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki.

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenCellNotEmpty()`

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

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateAfter(date)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z datami przypadającymi po określonej dacie.

Tych kryteriów możesz używać z dowolnym typem filtra. Jeśli używasz tych kryteriów z danymi, które połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą, ale jeśli tak nie jest, możesz otrzymać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Ostatnia data do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateAfter(date)`

Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami przypadającymi po określonej dacie względnej. Do zobaczyć opcje względnego zakresu dat, patrz Enum RelativeDate.

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

Parametry

Nazwa	Typ	Opis
`date`	`RelativeDate`	Najnowsza względna data.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateBefore(date)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z datami sprzed określonej daty.

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

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Data najwcześniejsza do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateBefore(date)`

Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami, które przypadają przed określoną datą względną. Aby wyświetlić opcje względnej daty, zobacz Enum RelativeDate.

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

Parametry

Nazwa	Typ	Opis
`date`	`RelativeDate`	Najwcześniejsza data względna do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateEqualTo(date)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z datami odpowiadającymi określonej dacie.

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

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Data, do której muszą być zgodne wartości w komórkach.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateEqualTo(date)`

Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami odpowiadającymi określonej dacie względnej. Aby wyświetlić opcje względnej daty, zobacz Enum RelativeDate.

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

Parametry

Nazwa	Typ	Opis
`date`	`RelativeDate`	Względna data, z którą muszą być zgodne wartości w komórkach.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateEqualToAny(dates)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z datami, które są równe dowolnej z podanych dat.

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Na przykład użyj tego z filtrami w arkuszu DataSource, czyli arkuszu połączonym z bazy danych lub DataSourcePivotTable, tabelę przestawną utworzoną z arkusza DataSource.

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

Parametry

Nazwa	Typ	Opis
`dates`	`Date[]`	Daty do wyświetlenia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateNotEqualTo(date)`

Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są zgodne z określoną datą.

Typ danych w kolumnie, według której przeprowadzasz filtrowanie, musi być datą.

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

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Data do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenDateNotEqualToAny(dates)`

Ustawia kryteria filtrowania tak, aby wyświetlać komórki z datami, które nie są równe żadnej z podanych wartości daty.

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

Parametry

Nazwa	Typ	Opis
`dates`	`Date[]`	Daty do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenFormulaSatisfied(formula)`

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

Tych kryteriów 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();
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);

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Formuła niestandardowa, która zwraca wartość `true`, jeśli dane wejściowe są prawidłowe.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberBetween(start, end)`

Ustawia kryteria filtrowania, aby wyświetlić komórki zawierające liczbę mieszczącą się między 2 lub jedną z tych wartości określonych liczb.

Tych kryteriów możesz używać z dowolnym typem filtra. Jeśli używasz tych kryteriów z danymi, które jeśli jest ona połączona z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą, ale w przeciwnym razie możesz otrzymać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
`start`	`Number`	Najniższa liczba do wyświetlenia.
`end`	`Number`	Najwyższa liczba do wyświetlenia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberEqualTo(number)`

Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki z liczbą równą określonej liczbie.

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

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Wyświetlana liczba.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberEqualToAny(numbers)`

Ustawia kryteria filtrowania tak, aby wyświetlać komórki z liczbą równą dowolnej z podanych wartości liczby.

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

Parametry

Nazwa	Typ	Opis
`numbers`	`Number[]`	Liczby do wyświetlenia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberGreaterThan(number)`

Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki o liczbie większej niż określona

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

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najwyższa liczba do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberGreaterThanOrEqualTo(number)`

Ustawia kryteria filtrowania tak, aby wyświetlać komórki o liczbie równej określonemu lub większej od podanej numer.

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

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najniższa liczba do wyświetlenia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberLessThan(number)`

Ustawia kryteria filtra, aby wyświetlały się komórki z liczbą mniejszą od określonej wartości.

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

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najniższa liczba do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberLessThanOrEqualTo(number)`

Ustawia kryteria filtrowania tak, by wyświetlać komórki o liczbie mniejszej niż określona numer.

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

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najwyższa liczba do wyświetlenia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberNotBetween(start, end)`

Ustawia kryteria filtra, aby wyświetlały komórki z liczbą, która nie mieści się między określonych liczb.

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

Parametry

Nazwa	Typ	Opis
`start`	`Number`	Najniższa cyfra jest ukryta.
`end`	`Number`	Najwyższa liczba do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberNotEqualTo(number)`

Ustawia kryteria filtrowania tak, aby wyświetlały komórki z liczbą, która nie jest równa określonej liczbie.

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

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Liczba do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenNumberNotEqualToAny(numbers)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą, która nie jest równa żadnej z podanych wartości liczby.

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

Parametry

Nazwa	Typ	Opis
`numbers`	`Number[]`	Liczby do ukrycia.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextContains(text)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem zawierającym określony tekst. Tekst Wielkość liter nie jest rozróżniana.

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst, który musi zawierać komórka.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextDoesNotContain(text)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie zawiera określonego tekstu. Wielkość liter w tekście nie jest rozróżniana.

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst, którego komórka nie może zawierać.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextEndsWith(text)`

Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem. Tekst Wielkość liter nie jest rozróżniana.

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst, który musi zawierać koniec tekstu komórki.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextEqualTo(text)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który jest równy określonemu tekstowi. Tekst Wielkość liter nie jest rozróżniana.

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst, który musi być równy tekstowi komórki.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextEqualToAny(texts)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który jest równy dowolnemu z podanych tekstów . Wielkość liter w tekście nie jest rozróżniana.

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

Parametry

Nazwa	Typ	Opis
`texts`	`String[]`	Wartości tekstowe, które musi mieć komórka.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextNotEqualTo(text)`

Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który różni się od podanego tekstu. Wielkość liter w tekście nie jest rozróżniana.

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst, który nie może być równy tekstowi w komórce.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextNotEqualToAny(texts)`

Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie jest równy żadnej z podanych wartości . Wielkość liter w tekście nie jest rozróżniana.

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

Parametry

Nazwa	Typ	Opis
`texts`	`String[]`	Wartości tekstowe, których komórka nie może być równa.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`whenTextStartsWith(text)`

Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem rozpoczynającym się od określonego tekstu. Tekst Wielkość liter nie jest rozróżniana.

Tych kryteriów możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst, który musi zawierać początek tekstu w komórce.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.

`withCriteria(criteria, args)`

Ustawia kryteria filtra na warunek logiczny zdefiniowany przez wartości BooleanCriteria, np. jako CELL_EMPTY lub NUMBER_GREATER_THAN. Aby skopiować warunek logiczny z istniejących kryteriów, zdefiniuj parametry tej metody za pomocą znaczników getCriteriaType() i getCriteriaValues() na istniejących kryteriów.

Możesz używać tych kryteriów z każdym typem filtra, ale niektóre BooleanCriteria nie dotyczy 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();
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);

Parametry

Nazwa	Typ	Opis
`criteria`	`BooleanCriteria`	Typ kryteriów wartości logicznych.
`args`	`Object[]`	Tablica argumentów odpowiednich do typu kryterium; liczbę argumentów ich typ pasują do odpowiednich metod `when...()` powyżej.

Powrót

FilterCriteriaBuilder – narzędzie do tworzenia łańcuchów.