Class FilterCriteriaBuilder

FilterCriteriaBuilder

Aby dodać kryteria do filtra:

1. Utwórz konstruktor kryteriów za pomocą polecenia SpreadsheetApp.newFilterCriteria().
2. Dodaj ustawienia do kreatora za pomocą metod z tej klasy.
3. Użyj narzędzia build(), aby utworzyć kryteria z wybranymi ustawieniami.

Typowe zastosowania

Ukrywanie wartości w arkuszu

Poniższy przykład pobiera istniejący filtr w arkuszu i dodaje kryteria ukrywające w kolumnie C komórki zawierające słowa „witaj” lub „świecie”. Kryteriów z tego przykładu można używać w filtrach tylko w arkuszach Grid (domyślnym typie arkusza).

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

Pokaż tylko niepuste komórki

Poniższy przykład pokazuje dodanie filtra do arkusza DataSource połączonego z bazą danych, który ma kryteria wyświetlające tylko komórki z kolumny „Kategoria”, 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	Tworzy kryteria filtrowania za pomocą ustawień dodanych do kreatora kryteriów.
copy()	FilterCriteriaBuilder	Kopiuje kryteria filtra i tworzy konstruktor kryteriów, który można stosować do innego filtra.
getCriteriaType()	BooleanCriteria	Zwraca typ wartości logicznej kryterium, np. CELL_EMPTY.
getCriteriaValues()	Object[]	Zwraca tablicę argumentów kryteriów logicznych.
getHiddenValues()	String[]	Zwraca wartości ukryte przez filtr.
getVisibleBackgroundColor()	Color	Zwraca kolor tła używany jako kryterium 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	Ustawia kolor tła używany jako kryteria filtrowania.
setVisibleForegroundColor(visibleForegroundColor)	FilterCriteriaBuilder	Ustawia kolor pierwszego planu używany jako kryteria filtrowania.
setVisibleValues(values)	FilterCriteriaBuilder	Ustawia wartości wyświetlane w tabeli przestawnej.
whenCellEmpty()	FilterCriteriaBuilder	Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki.
whenCellNotEmpty()	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki, które nie są puste.
whenDateAfter(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie.
whenDateAfter(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie względnej.
whenDateBefore(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty.
whenDateBefore(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty względnej.
whenDateEqualTo(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania zawierające komórki z datami zgodnymi z określoną datą.
whenDateEqualTo(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami równymi określonej daty względnej.
whenDateEqualToAny(dates)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami takimi jak dowolna z podanych dat.
whenDateNotEqualTo(date)	FilterCriteriaBuilder	Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są zgodne z określoną datą.
whenDateNotEqualToAny(dates)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z datami, które nie są takie same jak żadna z podanych dat.
whenFormulaSatisfied(formula)	FilterCriteriaBuilder	Ustawia kryteria filtrowania tak, aby wyświetlać komórki z określoną formułą (np. =B:B<C:C), która daje wartość true.
whenNumberBetween(start, end)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą mieszczącą się między 2 określonymi liczbami lub któraś z nich.
whenNumberEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą równą określonej liczbie.
whenNumberEqualToAny(numbers)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbami równą dowolnej z określonych liczb.
whenNumberGreaterThan(number)	FilterCriteriaBuilder	Ustala kryteria filtrowania, aby wyświetlić komórki z liczbą większą od określonej wartości
whenNumberGreaterThanOrEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie większej lub równej określonej liczbie.
whenNumberLessThan(number)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą mniejszą niż określona liczba.
whenNumberLessThanOrEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie mniejszej niż lub równej określonej liczbie.
whenNumberNotBetween(start, end)	FilterCriteriaBuilder	Ustawia kryteria filtrowania w taki sposób, aby komórki z liczbą nie należącą do zakresu 2 określonych liczb nie znajdowały się między nimi.
whenNumberNotEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą, która nie jest równa określonej liczbie.
whenNumberNotEqualToAny(numbers)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą, która nie jest równa żadnej z określonych liczb.
whenTextContains(text)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki zawierające tekst zawierający 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, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem.
whenTextEqualTo(text)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem równym określonemu tekstowi.
whenTextEqualToAny(texts)	FilterCriteriaBuilder	Ustawia kryteria filtrowania w taki sposób, aby wyświetlać komórki z tekstem, który jest równy dowolnej z podanych wartości tekstowych.
whenTextNotEqualTo(text)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który nie jest równy określonemu tekstowi.
whenTextNotEqualToAny(texts)	FilterCriteriaBuilder	Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem, który nie jest równy żadnej z podanych wartości.
whenTextStartsWith(text)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który zaczyna się od określonego tekstu.
withCriteria(criteria, args)	FilterCriteriaBuilder	Ustawia kryteria filtrowania na warunek logiczny zdefiniowany przez wartości BooleanCriteria, np. CELL_EMPTY lub NUMBER_GREATER_THAN.

Szczegółowa dokumentacja

build()

Tworzy kryteria filtrowania za pomocą ustawień dodanych 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);

Powroty

FilterCriteria – kryteria filtrowania.

---

copy()

Kopiuje kryteria filtra i tworzy konstruktor kryteriów, który można stosować do innego filtra.

Tej metody możesz używać z każdym typem filtra. Jeśli używasz filtra arkusza, możesz je skopiować 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);

Powroty

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

---

getCriteriaType()

Zwraca typ wartości logicznej kryterium, np. CELL_EMPTY. Informacje o typach kryteriów logicznych znajdziesz w artykule o wyliczeniu BooleanCriteria.

Użytkownicy często używają tej metody, aby dodawać do filtra kryteria warunku logicznego bez zastępowania dotychczasowych kryteriów.

• Aby uzyskać argumenty kryterium, użyj funkcji getCriteriaValues().
• Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtra, przeczytaj sekcję withCriteria(criteria, args).

Tej metody możesz używać w przypadku każdego typu filtra. Jeśli kryterium filtra nie jest warunkiem logicznym, 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);

Powroty

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

---

getCriteriaValues()

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

Użytkownicy często używają tej metody, aby dodawać do filtra kryteria warunku logicznego bez zastępowania dotychczasowych kryteriów.

• Aby pobrać typ kryteriów logicznych, użyj getCriteriaType().
• Aby użyć typu i wartości kryteriów do utworzenia lub zmiany kryteriów filtra, przeczytaj sekcję withCriteria(criteria, args).

  Tej metody możesz używać 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);

  Powroty

  Object[] – tablica argumentów odpowiednich dla typu kryteriów logicznych. Liczba argumentów i ich typ są zgodne z odpowiednią metodą when...() klasy FilterCriteriaBuilder.

---

getHiddenValues()

Zwraca wartości ukryte przez filtr.

Użyj tego kryterium w filtrach w Grid arkuszach (domyślnym typem arkusza). Zwraca wartość null, jeśli wywołujesz tę metodę w przypadku innych rodzajó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);

Powroty

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

---

getVisibleBackgroundColor()

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

Użyj tego kryterium w filtrach w Grid arkuszach (domyślnym typem arkusza). Zwraca wartość null, jeśli wywołujesz tę metodę w przypadku innych rodzajó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);

Powroty

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 pozostają widoczne.

Użyj tego kryterium w filtrach w Grid arkuszach (domyślnym typem arkusza). Zwraca wartość null, jeśli wywołujesz tę metodę w przypadku innych rodzajó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);

Powroty

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

---

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

Powroty

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

---

setHiddenValues(values)

Ustawia wartości do ukrycia. Usuwa wszystkie istniejące i ukryte wartości.

Tych kryteriów możesz używać do filtrów tylko w Grid arkuszach (domyślnym typem 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

setVisibleBackgroundColor(visibleBackgroundColor)

Ustawia kolor tła używany jako kryteria filtrowania. Komórki z tym kolorem tła pozostają widoczne. Ustawienie kryteriów filtrowania kolorów tła powoduje usunięcie z tego kreatora wszystkich bieżących kryteriów filtra kolorów.

Tych kryteriów możesz używać do filtrów tylko w Grid arkuszach (domyślnym typem 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. Ta metoda nie obsługuje kolorów motywu.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

setVisibleForegroundColor(visibleForegroundColor)

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

Tych kryteriów możesz używać do filtrów tylko w Grid arkuszach (domyślnym typem 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. Ta metoda nie obsługuje kolorów motywu.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

setVisibleValues(values)

Ustawia wartości wyświetlane w tabeli przestawnej. Usuwa wszystkie istniejące i ukryte wartości.

Tych kryteriów możesz używać tylko do 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."
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 pokazania.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenCellEmpty()

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

Tego kryterium możesz używać z każdym 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);

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenCellNotEmpty()

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

Tego kryterium możesz używać z każdym 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);

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateAfter(date)

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

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli 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	Ostatni dzień do ukrycia.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateAfter(date)

Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie względnej. Aby wyświetlić opcje dat względnych, zapoznaj się z tabelą Wyliczenie RelativeDate.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli 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 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateBefore(date)

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

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli 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 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	Najwcześniejsza data do ukrycia.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateBefore(date)

Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty względnej. Aby wyświetlić opcje dat względnych, zapoznaj się z sekcją Wyliczenie RelativeDate.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli 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 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 względna data do ukrycia.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateEqualTo(date)

Ustawia kryteria filtrowania zawierające komórki z datami zgodnymi z określoną datą.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli 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 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, której wartości w komórkach muszą być zgodne.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateEqualTo(date)

Ustawia kryteria filtrowania, aby wyświetlać komórki z datami równymi określonej daty względnej. Aby wyświetlić opcje dat względnych, zapoznaj się z sekcją Wyliczenie RelativeDate.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli 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 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, do której muszą pasować wartości w komórkach.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateEqualToAny(dates)

Ustawia kryteria filtrowania, aby wyświetlać komórki z datami takimi jak dowolna z podanych dat.

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateNotEqualTo(date)

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

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

Typ danych w kolumnie, według której filtrujesz, 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenDateNotEqualToAny(dates)

Ustawia kryteria filtrowania, aby wyświetlać komórki z datami, które nie są takie same jak żadna z podanych dat.

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenFormulaSatisfied(formula)

Ustawia kryteria filtrowania tak, aby wyświetlać komórki z określoną formułą (np. =B:B<C:C), która daje 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberBetween(start, end)

Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą mieszczącą się między 2 określonymi liczbami lub któraś z nich.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberEqualTo(number)

Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą równą określonej liczbie.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, 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 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	Liczba do wyświetlenia.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberEqualToAny(numbers)

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

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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 "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 pokazania.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberGreaterThan(number)

Ustala kryteria filtrowania, aby wyświetlić komórki z liczbą większą od określonej wartości

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.

// 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	Największa liczba do ukrycia.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberGreaterThanOrEqualTo(number)

Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie większej lub równej określonej liczbie.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.

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

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberLessThan(number)

Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą mniejszą niż określona liczba.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.

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

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberLessThanOrEqualTo(number)

Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie mniejszej niż lub równej określonej liczbie.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.

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

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberNotBetween(start, end)

Ustawia kryteria filtrowania w taki sposób, aby komórki z liczbą nie należącą do zakresu 2 określonych liczb nie znajdowały się między nimi.

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.

// 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	Ukryj najniższą liczbę.
end	Number	Największa liczba do ukrycia.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberNotEqualTo(number)

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

Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.

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

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenNumberNotEqualToAny(numbers)

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

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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 "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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextContains(text)

Ustawia kryteria filtrowania, aby wyświetlać komórki zawierające tekst zawierający określony tekst. Wielkość liter w tekście nie jest rozróżniana.

Tego kryterium możesz używać z każdym 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.

Powroty

FilterCriteriaBuilder – kreator 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.

Tego kryterium możesz używać z każdym 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ć.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextEndsWith(text)

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

Tego kryterium możesz używać z każdym 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.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextEqualTo(text)

Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem równym określonemu tekstowi. Wielkość liter w tekście nie jest rozróżniana.

Tego kryterium możesz używać z każdym 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órym musi równać się tekst komórki.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextEqualToAny(texts)

Ustawia kryteria filtrowania w taki sposób, aby wyświetlać komórki z tekstem, który jest równy dowolnej z podanych wartości tekstowych. Wielkość liter w tekście nie jest rozróżniana.

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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 "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 być równa komórka.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextNotEqualTo(text)

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

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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 "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órego tekst w komórce nie może się równać.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextNotEqualToAny(texts)

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

Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable utworzonej 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 "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óre nie mogą być równe.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

whenTextStartsWith(text)

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

Tego kryterium możesz używać z każdym 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 komórki.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.

---

withCriteria(criteria, args)

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

Tego kryterium możesz używać z każdym typem filtra, ale niektóre właściwości BooleanCriteria nie mają zastosowania 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();
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 logicznych.
args	Object[]	Tablica argumentów odpowiednich do typu kryteriów; liczba argumentów i ich typ są zgodne z odpowiednimi metodami when...() powyżej.

Powroty

FilterCriteriaBuilder – kreator do tworzenia łańcuchów.