Bir filtreye ölçüt eklemek için aşağıdakileri yapmanız gerekir:
SpreadsheetApp.newFilterCriteria()
kullanarak ölçüt oluşturucuyu oluşturun.- Bu sınıftaki yöntemleri kullanarak ayarları oluşturucuya ekleyin.
- Ölçütleri belirlediğiniz ayarlarla birleştirmek için
build()
öğesini kullanın.
Yaygın kullanım alanları
Sayfada değerleri gizleme
Aşağıdaki örnek, bir sayfanın mevcut filtresini alır ve hücreleri gizleyen ölçütler ekler. "merhaba" içeren C sütunu veya "dünya". Bu örnekteki ölçütler yalnızcaGrid
sayfadaki filtreler, varsayılan sayfa türü olan sayfa türüdür.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["hello", "world"]) .build(); filter.setColumnFilterCriteria(3, criteria);
Yalnızca boş olmayan hücreleri göster
Aşağıdaki örnek,DataSource
sayfasına filtre ekler. Bu sayfa
bir veritabanına bağlı (yalnızca "Kategori"deki hücreleri gösteren ölçütlerle) sütun
bu bağlantılar boş değildir.
// 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);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
build() | FilterCriteria | Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini oluşturur. |
copy() | FilterCriteriaBuilder | Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur filtresini uygulayabilirsiniz. |
getCriteriaType() | BooleanCriteria | Ölçütlerin boole türünü döndürür (ör. CELL_EMPTY ). |
getCriteriaValues() | Object[] | Boole ölçütleri için bir bağımsız değişken dizisi döndürür. |
getHiddenValues() | String[] | Filtrenin gizlediği değerleri döndürür. |
getVisibleBackgroundColor() | Color | Filtre ölçütü olarak kullanılan arka plan rengini döndürür. |
getVisibleForegroundColor() | Color | Filtre ölçütü olarak kullanılan ön plan rengini döndürür. |
getVisibleValues() | String[] | Pivot tablo filtresinin gösterdiği değerleri döndürür. |
setHiddenValues(values) | FilterCriteriaBuilder | Gizlenecek değerleri ayarlar. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Filtre ölçütü olarak kullanılan arka plan rengini ayarlar. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Filtre ölçütü olarak kullanılan ön plan rengini ayarlar. |
setVisibleValues(values) | FilterCriteriaBuilder | Pivot tabloda gösterilecek değerleri ayarlar. |
whenCellEmpty() | FilterCriteriaBuilder | Filtre ölçütlerini boş hücreleri gösterecek şekilde ayarlar. |
whenCellNotEmpty() | FilterCriteriaBuilder | Filtre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar. |
whenDateAfter(date) | FilterCriteriaBuilder | Belirtilen tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateAfter(date) | FilterCriteriaBuilder | Belirtilen göreli tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateBefore(date) | FilterCriteriaBuilder | Belirtilen tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateBefore(date) | FilterCriteriaBuilder | Belirtilen göreli tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Belirtilen tarihe eşit tarihleri olan hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Belirtilen göreli tarihe eşit tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | Filtre ölçütlerini, tarihleri belirtilen tarihlerden herhangi birine eşit olan hücreleri gösterecek şekilde ayarlar. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Filtre ölçütlerini belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar. |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | Filtre ölçütlerini, tarihleri belirtilenlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar . |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Filtre ölçütlerini, şunu içeren belirtilen bir formüle (ör. =B:B<C:C ) sahip hücreleri gösterecek şekilde ayarlar
true olarak değerlendirilir. |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Filtre ölçütlerini, 2 arasında bir sayı olan veya 2'den biri olan hücreleri gösterecek şekilde ayarlar belirtir. |
whenNumberEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıya eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilenlerden herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar numaraları'na dokunun. |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıdan büyük olan hücreleri gösterecek şekilde ayarlar |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilenden büyük veya bu değere eşit olan hücreleri gösterecek şekilde ayarlar sayı. |
whenNumberLessThan(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıdan küçük bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilenden küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar sayı. |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | Filtre ölçütlerini, 2 sayısının arasında ve iki değerden biri olmayan hücreleri gösterecek şekilde ayarlar belirtir. |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıya eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar. |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilenlerin hiçbirine eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar numaraları'na dokunun. |
whenTextContains(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metni içeren metni içeren hücreleri gösterecek şekilde ayarlar. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metni içermeyen metni içeren hücreleri gösterecek şekilde ayarlar. |
whenTextEndsWith(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metinle biten metinlere sahip hücreleri gösterecek şekilde ayarlar. |
whenTextEqualTo(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metne eşit olan hücrelerin gösterileceği şekilde ayarlar. |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metnin herhangi birine eşit bir metin içeren hücreleri gösterecek şekilde ayarlar değerler. |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metne eşit olmayan bir metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metinlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar değerler. |
whenTextStartsWith(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metinle başlayan metin içeren hücreleri gösterecek şekilde ayarlar. |
withCriteria(criteria, args) | FilterCriteriaBuilder | Filtre ölçütlerini BooleanCriteria değerleri tarafından tanımlanan bir boole koşuluna ayarlar. Örneğin,
CELL_EMPTY veya NUMBER_GREATER_THAN olarak. |
Ayrıntılı belgeler
build()
Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini oluşturur.
// 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);
Return
FilterCriteria
— Filtre ölçütlerinin temsili.
copy()
Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur filtresini uygulayabilirsiniz.
Bu yöntemi tüm filtre türleriyle kullanabilirsiniz. Sayfa filtresi kullanıyorsanız şunları yapabilirsiniz: ölçütleri başka bir sütuna kopyalayın.
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);
Return
FilterCriteriaBuilder
— Bu filtre ölçütlerini temel alan bir filtre ölçütü oluşturucu.
getCriteriaType()
Ölçütlerin boole türünü döndürür (ör. CELL_EMPTY
). Türler hakkında bilgi edinmek için
Boole ölçütü için BooleanCriteria
sıralamasına bakın.
Kullanıcılar genellikle boole koşulu ölçütlerini değiştirmeden bir filtreye eklemek için bu yöntemi kullanır yardımcı olur.
- Ölçütlerin bağımsız değişkenlerini almak için
getCriteriaValues()
işlevini kullanın. - Filtre ölçütleri oluşturmak veya mevcut filtreleri değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için şu sayfaya bakın:
withCriteria(criteria, args)
Bu yöntemi tüm filtre türleri için kullanabilirsiniz. Filtre ölçütleri bir boole değeri değilse
koşul, null
değerini döndürür.
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);
Return
BooleanCriteria
— Boole ölçütlerinin türü veya ölçütler bir boole değilse null
koşul.
getCriteriaValues()
Boole ölçütleri için bir bağımsız değişken dizisi döndürür. Bazı boole ölçüt türleri
bağımsız değişkenlerini içerir ve boş bir dizi döndürür (örneğin, CELL_NOT_EMPTY
).
Kullanıcılar genellikle boole koşulu ölçütlerini değiştirmeden bir filtreye eklemek için bu yöntemi kullanır yardımcı olur.
- Boole ölçüt türünü almak için
getCriteriaType()
işlevini kullanın. - Filtre ölçütleri oluşturmak veya mevcut bir filtre ölçütünü değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için şu sayfaya bakın:
withCriteria(criteria, args)
Bu yöntemi tüm filtre türleri için kullanabilirsiniz.
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);
Return
Object[]
— Boole ölçüt türüne uygun bir bağımsız değişken dizisi. Bağımsız değişken sayısı ve türü,FilterCriteriaBuilder
sınıfının ilgiliwhen...()
yöntemiyle eşleşmelidir.
getHiddenValues()
Filtrenin gizlediği değerleri döndürür.
Bu ölçütleri, varsayılan sayfa türü olan Grid
sayfadaki filtrelerle kullanın.
Bu yöntemi diğer filtre türleri için çağırırsanız null
değerini döndürür.
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);
Return
String[]
: Filtrenin gizlediği bir değer dizisi.
getVisibleBackgroundColor()
Filtre ölçütü olarak kullanılan arka plan rengini döndürür. Bu arka plan rengine sahip hücreler kalır görünür.
Bu ölçütleri, varsayılan sayfa türü olan Grid
sayfadaki filtrelerle kullanın.
Bu yöntemi diğer filtre türleri için çağırırsanız null
değerini döndürür.
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);
Return
Color
— Filtre ölçütü olarak kullanılan arka plan rengi.
getVisibleForegroundColor()
Filtre ölçütü olarak kullanılan ön plan rengini döndürür. Ön plan rengi bu renkte olan hücreler kaldı görünür.
Bu ölçütleri, varsayılan sayfa türü olan Grid
sayfadaki filtrelerle kullanın.
Bu yöntemi diğer filtre türleri için çağırırsanız null
değerini döndürür.
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);
Return
Color
— Filtre ölçütü olarak kullanılan ön plan rengi.
getVisibleValues()
Pivot tablo filtresinin gösterdiği değerleri döndürür.
Bu ölçüt yalnızca bir veritabanına bağlı olmayan pivot tablolardaki filtreler içindir. Diğer filtre türleri için boş bir dizi döndürür.
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);
Return
String[]
: Pivot tablo filtresinin gösterdiği değerler dizisi.
setHiddenValues(values)
Gizlenecek değerleri ayarlar. Görünür veya gizli tüm değerleri temizler.
Bu ölçütü yalnızca varsayılan olarak Grid
sayfadaki filtreler için kullanabilirsiniz
sayfa türü.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | String[] | Gizlenecek değerlerin listesi. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
setVisibleBackgroundColor(visibleBackgroundColor)
Filtre ölçütü olarak kullanılan arka plan rengini ayarlar. Bu arka plan rengine sahip hücreler kalır görünür. Arka plan rengi filtresi ölçütü ayarladığınızda mevcut renk filtresi ölçütleri kaldırılır kullanabilirsiniz.
Bu ölçütü yalnızca varsayılan olarak Grid
sayfadaki filtreler için kullanabilirsiniz
sayfa türü.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
visibleBackgroundColor | Color | Ayarlanacak arka plan rengi. Renk RGB stilinde olmalıdır rengi. Bu yöntem, tema renklerini desteklemez. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
setVisibleForegroundColor(visibleForegroundColor)
Filtre ölçütü olarak kullanılan ön plan rengini ayarlar. Ön plan rengi bu renkte olan hücreler kaldı görünür. Ön plan rengi filtresi ölçütü ayarladığınızda mevcut renk filtresi ölçütleri kaldırılır kullanabilirsiniz.
Bu ölçütü yalnızca varsayılan olarak Grid
sayfadaki filtreler için kullanabilirsiniz
sayfa türü.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
visibleForegroundColor | Color | Ayarlanacak ön plan rengi. Renk RGB stilinde olmalıdır rengi. Bu yöntem, tema renklerini desteklemez. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
setVisibleValues(values)
Pivot tabloda gösterilecek değerleri ayarlar. Görünür veya gizli tüm değerleri temizler.
Bu ölçütleri yalnızca
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | String[] | Gösterilecek değerlerin listesi. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenCellEmpty()
Filtre ölçütlerini boş hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenCellNotEmpty()
Filtre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateAfter(date)
Belirtilen tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Gizlenecek en son tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateAfter(date)
Belirtilen göreli tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar. Alıcı:
göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate
bölümüne bakın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | RelativeDate | En son göreli tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateBefore(date)
Belirtilen tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Gizlenecek en erken tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateBefore(date)
Belirtilen göreli tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar.
Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate
bölümüne bakın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | RelativeDate | Gizlenecek en erken göreli tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateEqualTo(date)
Belirtilen tarihe eşit tarihleri olan hücreleri gösteren filtre ölçütlerini ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Hücre değerlerinin eşleşmesi gereken tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateEqualTo(date)
Belirtilen göreli tarihe eşit tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate
bölümüne bakın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | RelativeDate | Hücre değerlerinin eşleşmesi gereken göreli tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateEqualToAny(dates)
Filtre ölçütlerini, tarihleri belirtilen tarihlerden herhangi birine eşit olan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dates | Date[] | Gösterilecek tarihler. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateNotEqualTo(date)
Filtre ölçütlerini belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
Filtrelemede temel aldığınız sütunun veri türü tarih olmalıdır.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Gizlenecek tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateNotEqualToAny(dates)
Filtre ölçütlerini, tarihleri belirtilenlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar .
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dates | Date[] | Gizlenecek tarihler. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenFormulaSatisfied(formula)
Filtre ölçütlerini, şunu içeren belirtilen bir formüle (ör. =B:B<C:C
) sahip hücreleri gösterecek şekilde ayarlar
true
olarak değerlendirilir.
Bu ölçütleri yalnızca bir veritabanına bağlı olmayan verileri filtrelemek için kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Giriş geçerliyse true sonucunu veren özel formül. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberBetween(start, end)
Filtre ölçütlerini, 2 arasında bir sayı olan veya 2'den birinin arasında olan hücreleri gösterecek şekilde ayarlar belirtir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Number | Gösterilecek en düşük sayı. |
end | Number | Gösterilecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberEqualTo(number)
Filtre ölçütlerini, belirtilen sayıya eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gösterilecek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberEqualToAny(numbers)
Filtre ölçütlerini, belirtilenlerden herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar numaraları'na dokunun.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
numbers | Number[] | Gösterilecek sayılar. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberGreaterThan(number)
Filtre ölçütlerini, belirtilen sayıdan büyük olan hücreleri gösterecek şekilde ayarlar
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gizlenecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberGreaterThanOrEqualTo(number)
Filtre ölçütlerini, belirtilenden büyük veya bu değere eşit olan hücreleri gösterecek şekilde ayarlar sayı.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gösterilecek en düşük sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberLessThan(number)
Filtre ölçütlerini, belirtilen sayıdan küçük bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gizlenecek en düşük sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberLessThanOrEqualTo(number)
Filtre ölçütlerini, belirtilenden küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar sayı.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gösterilecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberNotBetween(start, end)
Filtre ölçütlerini, 2 sayısının arasında ve iki değerden biri olmayan hücreleri gösterecek şekilde ayarlar belirtir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Number | En küçük sayıyı gizler. |
end | Number | Gizlenecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberNotEqualTo(number)
Filtre ölçütlerini, belirtilen sayıya eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gizlenecek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberNotEqualToAny(numbers)
Filtre ölçütlerini, belirtilenlerin herhangi birine eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar numaraları'na dokunun.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
numbers | Number[] | Gizlenecek sayılar. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextContains(text)
Filtre ölçütlerini, belirtilen metni içeren metni içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücrede bulunması gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextDoesNotContain(text)
Filtre ölçütlerini, belirtilen metni içermeyen metni içeren hücreleri gösterecek şekilde ayarlar. İlgili içeriği oluşturmak için kullanılan metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücrede içermemesi gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextEndsWith(text)
Filtre ölçütlerini, belirtilen metinle biten metinlere sahip hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücre metninin sonunda yer alması gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextEqualTo(text)
Filtre ölçütlerini, belirtilen metne eşit olan hücrelerin gösterileceği şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücre metninin eşit olması gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextEqualToAny(texts)
Filtre ölçütlerini, belirtilen metnin herhangi birine eşit bir metin içeren hücreleri gösterecek şekilde ayarlar değerler. Metin, büyük/küçük harfe duyarlı değildir.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
texts | String[] | Bir hücrenin eşit olması gereken metin değerleri. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextNotEqualTo(text)
Filtre ölçütlerini, belirtilen metne eşit olmayan bir metin içeren hücreleri gösterecek şekilde ayarlar. İlgili içeriği oluşturmak için kullanılan metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücre metninin eşit olamayacağı metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextNotEqualToAny(texts)
Filtre ölçütlerini, belirtilen metinlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar değerler. Metin, büyük/küçük harfe duyarlı değildir.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın:
filtresi uygulanmış bir sayfadır. DataSource
sayfasında,
veritabanı veya DataSourcePivotTable
, DataSource
sayfasından oluşturulmuş bir pivot tablodur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
texts | String[] | Bir hücrenin eşit olamayacağı metin değerleri. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextStartsWith(text)
Filtre ölçütlerini, belirtilen metinle başlayan metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücre metninin başında yer alması gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
withCriteria(criteria, args)
Filtre ölçütlerini BooleanCriteria
değerleri tarafından tanımlanan bir boole koşuluna ayarlar. Örneğin,
CELL_EMPTY
veya NUMBER_GREATER_THAN
olarak. Boole koşulunu şuradan kopyalamak için:
Mevcut ölçütlere göre, bir uygulamada getCriteriaType()
ve getCriteriaValues()
kullanarak bu yöntemin parametrelerini tanımlayın.
yardımcı olur.
Bu ölçütleri herhangi bir filtre türünde kullanabilirsiniz ancak bazı BooleanCriteria
türleri kullanılamaz
tüm filtreler için geçerlidir.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
criteria | BooleanCriteria | Boole ölçütlerinin türü. |
args | Object[] | Ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişken sayısını
türleri yukarıdaki karşılık gelen when...() yöntemleriyle eşleşmelidir. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.