Aby dodać kryteria do filtra:
- Utwórz kreator kryteriów za pomocą właściwości
SpreadsheetApp.newFilterCriteria()
. - Dodaj ustawienia do kreatora, korzystając z metod z tej klasy.
- Użyj narzędzia
build()
, aby połączyć kryteria z wybranymi ustawieniami.
Typowe zastosowania
Ukrywanie wartości w arkuszu
Poniższy przykład pobiera istniejący filtr arkusza i dodaje kryteria ukrywające komórki w kolumnę C z wyrażeniem „hello” czy „świat”. Kryteria z tej próbki mogą być używane tylko z filtry (domyślny typ arkusza) w arkuszuGrid
.
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 arkuszaDataSource
, czyli arkusza, który
połączone z bazą danych z kryteriami, które powodują wyświetlanie tylko komórek w kategorii „Kategoria” kolumna
które nie są puste.
// Gets the sheet named "Connected sheet," which is connected to a database. let sheet = SpreadsheetApp.getActiveSpreadsheet() .getSheetByName("Connected sheet") .asDataSourceSheet(); // Creates criteria that only shows non-empty cells. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); // Applies the criteria to the column named "Category." sheet.addFilter("Category", criteria);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | FilterCriteria | Łączy kryteria filtrowania, używając ustawień dodanych przez Ciebie do Kreatora kryteriów. |
copy() | FilterCriteriaBuilder | Skopiowanie kryteriów filtra i utworzenie kreatora kryteriów, które można zastosować do innego filtr. |
getCriteriaType() | BooleanCriteria | Zwraca typ wartości logicznej kryterium, na przykład CELL_EMPTY . |
getCriteriaValues() | Object[] | Zwraca tablicę argumentów dla kryteriów wartości logicznych. |
getHiddenValues() | String[] | Zwraca wartości ukrywane przez filtr. |
getVisibleBackgroundColor() | Color | Zwraca kolor tła używany jako kryteria filtra. |
getVisibleForegroundColor() | Color | Zwraca kolor pierwszego planu używany jako kryterium filtra. |
getVisibleValues() | String[] | Zwraca wartości wyświetlane przez filtr tabeli przestawnej. |
setHiddenValues(values) | FilterCriteriaBuilder | Ustawia wartości do ukrycia. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Określa kolor tła używany jako kryteria filtra. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Ustawia kolor pierwszego planu używany jako kryteria filtra. |
setVisibleValues(values) | FilterCriteriaBuilder | Ustawia wartości, które mają być wyświetlane w tabeli przestawnej. |
whenCellEmpty() | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki. |
whenCellNotEmpty() | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki, które nie są puste. |
whenDateAfter(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z datami przypadającymi po określonej dacie. |
whenDateAfter(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami przypadającymi po określonej dacie względnej. |
whenDateBefore(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z datami sprzed określonej daty. |
whenDateBefore(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami, które przypadają przed określoną datą względną. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z datami odpowiadającymi określonej dacie. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami odpowiadającymi określonej dacie względnej. |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z datami, które są równe dowolnej z podanych dat. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są zgodne z określoną datą. |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki z datami, które nie są równe żadnej z podanych wartości daty. |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z określoną formułą (np. =B:B<C:C ), która
zwraca wartość true . |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki zawierające liczbę mieszczącą się między 2 lub jedną z tych wartości określonych liczb. |
whenNumberEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki z liczbą równą określonej liczbie. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki z liczbą równą dowolnej z podanych wartości liczby. |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki o liczbie większej niż określona |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki o liczbie równej określonemu lub większej od podanej numer. |
whenNumberLessThan(number) | FilterCriteriaBuilder | Ustawia kryteria filtra, aby wyświetlały się komórki z liczbą mniejszą od określonej wartości. |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, by wyświetlać komórki o liczbie mniejszej niż określona numer. |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | Ustawia kryteria filtra, aby wyświetlały komórki z liczbą, która nie mieści się między określonych liczb. |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlały komórki z liczbą, która nie jest równa określonej liczbie. |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą, która nie jest równa żadnej z podanych wartości liczby. |
whenTextContains(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem zawierającym określony tekst. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie zawiera określonego tekstu. |
whenTextEndsWith(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem. |
whenTextEqualTo(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który jest równy określonemu tekstowi. |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który jest równy dowolnemu z podanych tekstów . |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który różni się od podanego tekstu. |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie jest równy żadnej z podanych wartości . |
whenTextStartsWith(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem rozpoczynającym się od określonego tekstu. |
withCriteria(criteria, args) | FilterCriteriaBuilder | Ustawia kryteria filtra na warunek logiczny zdefiniowany przez wartości BooleanCriteria , np.
jako CELL_EMPTY lub NUMBER_GREATER_THAN . |
Szczegółowa dokumentacja
build()
Łączy kryteria filtrowania, używając ustawień dodanych przez Ciebie do Kreatora kryteriów.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() // Creates a criteria builder. .whenCellNotEmpty() // Adds settings to the builder. .build(); // Assembles the criteria. filter.setColumnFilterCriteria(2, criteria);
Powrót
FilterCriteria
– reprezentuje kryteria filtrowania.
copy()
Skopiowanie kryteriów filtra i utworzenie kreatora kryteriów, które można zastosować do innego filtr.
Tej metody możesz używać z każdym typem filtra. Jeśli używasz filtra arkusza, możesz skopiować kryteria do innej kolumny.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Makes a copy of the filter criteria applied to column C. let criteria = filter.getColumnFilterCriteria(3).copy().build(); // Applies the copied criteria to column B. The copied criteria overwrites any existing // criteria on column B. filter.setColumnFilterCriteria(2, criteria);
Powrót
FilterCriteriaBuilder
– kreator kryteriów filtrowania oparty na tych kryteriach filtrowania.
getCriteriaType()
Zwraca typ wartości logicznej kryterium, na przykład CELL_EMPTY
. Więcej informacji o typach
kryteriów wartości logicznych, zobacz wyliczenie BooleanCriteria
.
Użytkownicy często korzystają z tej metody do dodawania do filtra kryteriów warunku logicznego bez zastępowania istniejących kryteriów.
- Aby uzyskać argumenty kryteriów, użyj funkcji
getCriteriaValues()
. - Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtrowania, zapoznaj się z artykułem
withCriteria(criteria, args)
Możesz użyć tej metody w przypadku każdego typu filtra. Jeśli kryteria filtrowania nie są wartościami logicznymi
warunku, zwraca null
.
let ss = SpreadsheetApp.getActiveSheet(); // Gets the filter on the active sheet. let filter = ss.getFilter(); // Gets the criteria type and returns a string representing the criteria type object. let criteriaType = filter.getColumnFilterCriteria(2) .getCriteriaType() .toString(); // Logs the criteria type. console.log(criteriaType);
Powrót
BooleanCriteria
– typ kryteriów wartości logicznej lub null
, jeśli nie są one wartościami logicznymi.
.
getCriteriaValues()
Zwraca tablicę argumentów dla kryteriów wartości logicznych. Niektóre typy kryteriów wartości logicznych nie mają
i zwraca pustą tablicę, np. CELL_NOT_EMPTY
.
Użytkownicy często korzystają z tej metody do dodawania do filtra kryteriów warunku logicznego bez zastępowania istniejących kryteriów.
- Aby uzyskać typ kryteriów wartości logicznej, użyj
getCriteriaType()
. - Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtrowania, zapoznaj się z artykułem
withCriteria(criteria, args)
Możesz użyć tej metody w przypadku każdego typu filtra.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Gets the values of the boolean criteria and logs them. For example, if the boolean // condition is whenNumberGreaterThan(10), then the logged value is 10. let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues(); console.log(criteriaValues);
Powrót
Object[]
– tablica argumentów odpowiednich dla typu kryteriów wartości logicznych. Liczba argumentów i ich typ pasują do odpowiedniej metodywhen...()
klasyFilterCriteriaBuilder
.
getHiddenValues()
Zwraca wartości ukrywane przez filtr.
Użyj tych kryteriów w przypadku filtrów w Grid
arkuszach (domyślny typ arkusza).
Zwraca null
, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Gets the filter criteria applied to column B, then gets the hidden values. let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues(); // Logs the hidden values. console.log(filterCriteria);
Powrót
String[]
– tablica wartości ukrywanych przez filtr.
getVisibleBackgroundColor()
Zwraca kolor tła używany jako kryteria filtra. Komórki z tym kolorem tła pozostaną widoczne.
Użyj tych kryteriów w przypadku filtrów w Grid
arkuszach (domyślny typ arkusza).
Zwraca null
, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Logs the background color that column B is filtered by as a hexadecimal string. let filter = range.getFilter(); let color = filter.getColumnFilterCriteria(2) .getVisibleBackgroundColor() .asRgbColor() .asHexString(); console.log(color);
Powrót
Color
– kolor tła używany jako kryterium filtra.
getVisibleForegroundColor()
Zwraca kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem pierwszego planu pozostaną widoczne.
Użyj tych kryteriów w przypadku filtrów w Grid
arkuszach (domyślny typ arkusza).
Zwraca null
, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Logs the foreground color that column B is filtered by as a hexadecimal string. let filter = range.getFilter(); let color = filter.getColumnFilterCriteria(2) .getVisibleForegroundColor() .asRgbColor() .asHexString(); console.log(color);
Powrót
Color
– kolor pierwszego planu używany jako kryterium filtra.
getVisibleValues()
Zwraca wartości wyświetlane przez filtr tabeli przestawnej.
To kryterium dotyczy tylko filtrów w tabelach przestawnych, które nie są połączone z bazą danych. Zwraca pustą tablicę w przypadku innych typów filtrów.
let ss = SpreadsheetApp.getActiveSheet(); // Gets the first pivot table on the sheet, then gets the visible values of its first filter. pivotTable = ss.getPivotTables()[0]; pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues(); // Logs the visible values. console.log(pivotFilterValues);
Powrót
String[]
– tablica wartości wyświetlanych przez filtr tabeli przestawnej.
setHiddenValues(values)
Ustawia wartości do ukrycia. Usuwa wszystkie widoczne i ukryte wartości.
Tych kryteriów możesz użyć tylko w przypadku filtrów w Grid
arkuszach (domyślnie
typu arkusza.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets the values to hide and applies the criteria to column C. let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["Hello", "World"]) .build(); filter.setColumnFilterCriteria(3, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Lista wartości do ukrycia. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
setVisibleBackgroundColor(visibleBackgroundColor)
Określa kolor tła używany jako kryteria filtra. Komórki z tym kolorem tła pozostaną widoczne. Ustawienie kryteriów filtrowania koloru tła usuwa wszystkie bieżące kryteria filtrowania kolorów z tego kreatora.
Tych kryteriów możesz użyć tylko w przypadku filtrów w Grid
arkuszach (domyślnie
typu arkusza.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that filters by background color and sets it to column B. let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build(); let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleBackgroundColor(color) .build(); filter.setColumnFilterCriteria(2, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
visibleBackgroundColor | Color | Kolor tła do ustawienia. Kolor musi być w stylu RGB koloru. Ta metoda nie obsługuje kolorów motywu. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
setVisibleForegroundColor(visibleForegroundColor)
Ustawia kolor pierwszego planu używany jako kryteria filtra. Komórki z tym kolorem pierwszego planu pozostaną widoczne. Ustawienie kryteriów filtrowania koloru pierwszego planu powoduje usunięcie wszystkich bieżących kryteriów filtrowania kolorów z tego kreatora.
Tych kryteriów możesz użyć tylko w przypadku filtrów w Grid
arkuszach (domyślnie
typu arkusza.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that filters by foreground color and sets it to column B. let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build(); let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleForegroundColor(color) .build(); filter.setColumnFilterCriteria(2, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
visibleForegroundColor | Color | Kolor pierwszego planu do ustawienia. Kolor musi być w stylu RGB koloru. Ta metoda nie obsługuje kolorów motywu. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
setVisibleValues(values)
Ustawia wartości, które mają być wyświetlane w tabeli przestawnej. Usuwa wszystkie widoczne i ukryte wartości.
Tego kryterium możesz używać tylko w przypadku filtrów w tabelach przestawnych, które nie są połączone z w bazie danych.
// Gets the active sheet. const ss = SpreadsheetApp.getActiveSheet(); // Gets the first pivot table on the sheet and adds a filter to it that // sets the visible values to "Northeast" and "Southwest." let pivotTable = ss.getPivotTables()[0]; let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleValues(["Northeast", "Southwest"]) .build(); pivotTable.addFilter(2, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Lista wartości do wyświetlenia. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenCellEmpty()
Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki.
Tych kryteriów możesz używać z dowolnym typem filtra.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets criteria to column B that only shows empty cells. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellEmpty() .build(); filter.setColumnFilterCriteria(2, criteria);
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenCellNotEmpty()
Ustawia kryteria filtrowania, aby wyświetlić komórki, które nie są puste.
Tych kryteriów możesz używać z dowolnym typem filtra.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets criteria to column B that only shows cells that aren't empty. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria);
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenDateAfter(date)
Ustawia kryteria filtrowania, aby wyświetlić komórki z datami przypadającymi po określonej dacie.
Tych kryteriów możesz używać z dowolnym typem filtra. Jeśli używasz tych kryteriów z danymi, które połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą, ale jeśli tak nie jest, możesz otrzymać nieoczekiwane wyniki.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates after June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateAfter(date) .build(); filter.setColumnFilterCriteria(1, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Ostatnia data do ukrycia. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenDateAfter(date)
Ustawia kryteria filtrowania, które powoduje wyświetlenie komórek z datami przypadającymi po określonej dacie względnej. Do
zobaczyć opcje względnego zakresu dat, patrz Enum RelativeDate
.
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 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 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 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 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, aby wyświetlić komórki z datami, które są równe dowolnej z podanych dat.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Na przykład użyj tego
z filtrami w arkuszu DataSource
, czyli arkuszu połączonym z
bazy danych lub DataSourcePivotTable
, tabelę przestawną utworzoną z arkusza DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "date" column that shows cells with any of the below dates. let date1 = new Date("June 1, 2022"); let date2 = new Date("June 2, 2022"); let date3 = new Date("June 3, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualToAny([date1, date2, date3]) .build(); dataSheet.addFilter("date", criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
dates | Date[] | Daty do wyświetlenia. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenDateNotEqualTo(date)
Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są zgodne z określoną datą.
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 jeśli jest ona połączona z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą, ale w przeciwnym razie możesz otrzymać nieoczekiwane wyniki.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that only shows cells with numbers that fall between 1-25, inclusively, // and sets it to column A. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberBetween(1, 25) .build(); filter.setColumnFilterCriteria(1, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa liczba do wyświetlenia. |
end | Number | Najwyższa liczba do wyświetlenia. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenNumberEqualTo(number)
Ustawia kryteria filtrowania w taki sposób, aby wyświetlały się komórki z liczbą równą określonej liczbie.
Tych kryteriów możesz używać z dowolnym typem filtra. Jeśli używasz tych kryteriów z danymi, które jeśli jest ona połączona z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą, ale w przeciwnym razie możesz otrzymać nieoczekiwane wyniki.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that only shows cells 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 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 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 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 less than 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberLessThan(10) .build(); filter.setColumnFilterCriteria(2, criteria);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa liczba do ukrycia. |
Powrót
FilterCriteriaBuilder
– narzędzie do tworzenia łańcuchów.
whenNumberLessThanOrEqualTo(number)
Ustawia kryteria filtrowania tak, by wyświetlać komórki o liczbie mniejszej niż określona numer.
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 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 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 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.