Class FilterCriteriaBuilder

FilterCriteriaBuilder

Aby dodać kryteria do filtra:

1. Utwórz kreator kryteriów za pomocą właściwości SpreadsheetApp.newFilterCriteria().
2. Dodaj ustawienia do kreatora, korzystając z metod z tej klasy.
3. 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łączona 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 tak, aby wyświetlać 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ą podanej 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 w taki sposób, aby wyświetlać komórki o liczbie mniejszej od określonej lub jej równej 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.

Możesz użyć tego kryterium tylko w przypadku filtrów w Grid arkuszach (domyślnie jest to możliwe) 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.

Rzuty

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

---

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.

Możesz użyć tego kryterium tylko w przypadku filtrów w Grid arkuszach (domyślnie jest to możliwe) 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.

Możesz użyć tego kryterium tylko w przypadku filtrów w Grid arkuszach (domyślnie jest to możliwe) 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.

Rzuty

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

---

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.

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

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

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

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

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 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 tak, aby wyświetlać 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ą.

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.

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.

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 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 połączone 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ą podanej liczbie.

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

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

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

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

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ć 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 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 w taki sposób, aby wyświetlać komórki o liczbie mniejszej od określonej lub jej równej numer.

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

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

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

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

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

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

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