Class FilterCriteriaBuilder

FilterCriteriaBuilder

Bir filtreye ölçüt eklemek için aşağıdakileri yapmanız gerekir:

  1. SpreadsheetApp.newFilterCriteria() ile ölçüt oluşturucuyu oluşturun.
  2. Bu sınıftaki yöntemleri kullanarak derleyiciye ayarlar ekleyin.
  3. Ölçütleri belirttiğiniz ayarlarla derlemek için build() kullanın.

Yaygın kullanım alanları

Sayfadaki değerleri gizleme

Aşağıdaki örnek, bir sayfanın mevcut filtresini alır ve C sütununda "merhaba" veya "dünya" içeren hücreleri gizleyen ölçütler ekler. Bu örnekteki ölçütler yalnızca varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanılabilir.
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 bir DataSource sayfasına, veritabanına bağlı bir sayfa olan ve "Kategori" sütununda yalnızca boş olmayan hücreleri gösteren bir filtre ekler.
// 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öntemDönüş türüKısa açıklama
build()FilterCriteriaÖlçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini birleştirir.
copy()FilterCriteriaBuilderBu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur.
getCriteriaType()BooleanCriteriaÖlçütün boole türünü döndürür (örneğin, 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()ColorFiltre ölçütü olarak kullanılan arka plan rengini döndürür.
getVisibleForegroundColor()ColorFiltre ö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)FilterCriteriaBuilderGizlenecek değerleri ayarlar.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderFiltre ölçütü olarak kullanılan arka plan rengini ayarlar.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderFiltre ölçütü olarak kullanılan ön plan rengini ayarlar.
setVisibleValues(values)FilterCriteriaBuilderPivot tabloda gösterilecek değerleri ayarlar.
whenCellEmpty()FilterCriteriaBuilderFiltre ölçütlerini boş hücreleri gösterecek şekilde ayarlar.
whenCellNotEmpty()FilterCriteriaBuilderFiltre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar.
whenDateAfter(date)FilterCriteriaBuilderBelirtilen tarihten sonra gelen hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateAfter(date)FilterCriteriaBuilderBelirtilen göreli tarihten sonraki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateBefore(date)FilterCriteriaBuilderBelirtilen tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateBefore(date)FilterCriteriaBuilderBelirtilen göreli tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualTo(date)FilterCriteriaBuilderBelirtilen tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualTo(date)FilterCriteriaBuilderBelirtilen göreli tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualToAny(dates)FilterCriteriaBuilderFiltre ölçütlerini, tarihleri belirtilen tarihlerden herhangi birine eşit olan hücreleri gösterecek şekilde ayarlar.
whenDateNotEqualTo(date)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderFiltre ölçütlerini, tarihleri belirtilen tarihlerden hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar.
whenFormulaSatisfied(formula)FilterCriteriaBuilderFiltre ölçütlerini, true olarak değerlendirilen belirtilen bir formüle (=B:B<C:C gibi) sahip hücreleri gösterecek şekilde ayarlar.
whenNumberBetween(start, end)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen 2 sayının arasında veya bu 2 sayının arasında bir sayı olan hücreleri gösterecek şekilde ayarlar.
whenNumberEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıya eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayılardan herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenNumberGreaterThan(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan büyük bir sayı içeren hücreleri gösterecek şekilde ayarlar
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan büyük veya bu sayıya eşit olan hücreleri gösterecek şekilde ayarlar.
whenNumberLessThan(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan küçük bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar.
whenNumberNotBetween(start, end)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen 2 sayıdan biri olmayan ve bu sayılar arasında yer almayan hücreleri gösterecek şekilde ayarlar.
whenNumberNotEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıya eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıların hiçbirine eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenTextContains(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metni içeren metni içeren hücreleri gösterecek şekilde ayarlar.
whenTextDoesNotContain(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metni içermeyen metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextEndsWith(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metinle biten metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextEqualTo(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metne eşit metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextEqualToAny(texts)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metin değerlerinden herhangi birine eşit metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextNotEqualTo(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metne eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen değerlerden hiçbirine eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextStartsWith(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metinle başlayan metin içeren hücreleri gösterecek şekilde ayarlar.
withCriteria(criteria, args)FilterCriteriaBuilderFiltre ölçütlerini CELL_EMPTY veya NUMBER_GREATER_THAN gibi BooleanCriteria değerleriyle tanımlanan bir boole koşuluna ayarlar.

Ayrıntılı belgeler

build()

Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini birleştirir.

// 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çütlerini temsil eder.


copy()

Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur.

Bu yöntemi tüm filtre türleriyle kullanabilirsiniz. Sayfa filtresi kullanıyorsanız ölçütleri başka bir sütuna kopyalayabilirsiniz.

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çütün boole türünü döndürür (örneğin, CELL_EMPTY). Boole ölçütü türleri hakkında bilgi edinmek için BooleanCriteria sıralamasına bakın.

Kullanıcılar genellikle bu yöntemi mevcut ölçütleri değiştirmeden bir filtreye boole koşulu ölçütleri eklemek için kullanır.

  • Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() işlevini kullanın.
  • Filtre ölçütlerini oluşturmak veya değiştirmek amacıyla ölçüt türünü ve ölçüt değerlerini kullanmak için withCriteria(criteria, args) bölümüne bakın.

Bu yöntemi tüm filtre türleri için kullanabilirsiniz. Filtre ölçütü bir boole koşulu değilse 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çütünün türü. Ölçüt bir boole koşulu değilse null.


getCriteriaValues()

Boole ölçütleri için bir bağımsız değişken dizisi döndürür. Bazı boole ölçüt türlerinin bağımsız değişkenleri yoktur ve boş bir dizi döndürür. Örneğin, CELL_NOT_EMPTY.

Kullanıcılar genellikle bu yöntemi mevcut ölçütleri değiştirmeden bir filtreye boole koşulu ölçütleri eklemek için kullanır.

  • Boole ölçüt türünü almak için getCriteriaType() işlevini kullanın.
  • Filtre ölçütü oluşturmak veya değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için withCriteria(criteria, args) bölümüne bakın.

    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şkenlerin sayısı ve türleri, FilterCriteriaBuilder sınıfının karşılık gelen when...() yöntemiyle eşleşir.


getHiddenValues()

Filtrenin gizlediği değerleri döndürür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Diğer filtre türleri için bu yöntemi ç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 görünür kalır.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Diğer filtre türleri için bu yöntemi ç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. Bu ön plan rengine sahip hücreler görünür durumda kalır.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Diğer filtre türleri için bu yöntemi ç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 bir değer dizisi.


setHiddenValues(values)

Gizlenecek değerleri ayarlar. Mevcut görünür veya gizli değerleri temizler.

Bu ölçütleri yalnızca varsayılan sayfa türü olan Grid sayfalarındaki filtreler için kullanabilirsiniz.

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

AdTürAçıklama
valuesString[]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 görünür kalır. Bir arka plan renk filtresi ölçütü ayarlamak, geçerli renk filtresi ölçütlerini bu oluşturucudan kaldırır.

Bu ölçütleri yalnızca varsayılan sayfa türü olan Grid sayfalarındaki filtreler için kullanabilirsiniz.

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

AdTürAçıklama
visibleBackgroundColorColorAyarlanacak arka plan rengi. Renk, RGB tarzı bir renk olmalıdır. 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. Bu ön plan rengine sahip hücreler görünür durumda kalır. Ön plan renk filtresi ölçütü ayarlamak, geçerli renk filtresi ölçütlerini bu oluşturucudan kaldırır.

Bu ölçütleri yalnızca varsayılan sayfa türü olan Grid sayfalarındaki filtreler için kullanabilirsiniz.

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

AdTürAçıklama
visibleForegroundColorColorAyarlanacak ön plan rengi. Renk, RGB tarzı bir renk olmalıdır. Bu yöntem tema renklerini desteklemez.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


setVisibleValues(values)

Pivot tabloda gösterilecek değerleri ayarlar. Mevcut görünür veya gizli değerleri temizler.

Bu ölçütleri yalnızca bir veritabanına bağlı olmayan pivot tablolardaki filtreler için kullanabilirsiniz.

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

AdTürAçıklama
valuesString[]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 gelen hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen 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

AdTürAçıklama
dateDateGizlenecek en son tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateAfter(date)

Belirtilen göreli tarihten sonraki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate'a bakın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen 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

AdTürAçıklama
dateRelativeDateEn son göreli tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateBefore(date)

Belirtilen tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen 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

AdTürAçıklama
dateDateGizlenecek en erken tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateBefore(date)

Belirtilen göreli tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate'a bakın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen 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

AdTürAçıklama
dateRelativeDateGizlenecek en eski göreli tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateEqualTo(date)

Belirtilen tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen 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

AdTürAçıklama
dateDateHücre değerlerinin eşleşmesi gereken tarihtir.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateEqualTo(date)

Belirtilen göreli tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate'a bakın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen 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

AdTürAçıklama
dateRelativeDateHü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, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
datesDate[]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, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

Filtreleme ölçütü olarak kullandığı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

AdTürAçıklama
dateDateGizlenecek tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateNotEqualToAny(dates)

Filtre ölçütlerini, tarihleri belirtilen tarihlerden 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, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
datesDate[]Gizlenecek tarihler.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenFormulaSatisfied(formula)

Filtre ölçütlerini, true olarak değerlendirilen belirtilen bir formüle (=B:B<C:C gibi) sahip hücreleri gösterecek şekilde ayarlar.

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

AdTürAçıklama
formulaStringGiriş geçerliyse true sonucunu veren özel bir formül.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberBetween(start, end)

Filtre ölçütlerini, belirtilen 2 sayının arasında veya bu 2 sayının arasında bir sayı olan hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
startNumberGösterilecek en düşük sayı.
endNumberGö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 bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
numberNumberGösterilecek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberEqualToAny(numbers)

Filtre ölçütlerini, belirtilen sayılardan herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
numbersNumber[]Gösterilecek sayılar.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberGreaterThan(number)

Filtre ölçütlerini, belirtilen sayıdan büyük bir sayı içeren hücreleri gösterecek şekilde ayarlar

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
numberNumberGizlenecek en yüksek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberGreaterThanOrEqualTo(number)

Filtre ölçütlerini, belirtilen sayıdan büyük veya bu sayıya eşit olan hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
numberNumberGö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 bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
numberNumberGizlenecek en düşük sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberLessThanOrEqualTo(number)

Filtre ölçütlerini, belirtilen sayıdan küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
numberNumberGösterilecek en yüksek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberNotBetween(start, end)

Filtre ölçütlerini, belirtilen 2 sayıdan biri olmayan ve bu sayılar arasında yer almayan hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
startNumberEn düşük sayı gizlenir.
endNumberGizlenecek 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ıya sahip hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı 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

AdTürAçıklama
numberNumberGizlenecek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberNotEqualToAny(numbers)

Filtre ölçütlerini, belirtilen sayıların hiçbirine eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
numbersNumber[]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

AdTürAçıklama
textStringHücrenin içermesi gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextDoesNotContain(text)

Filtre ölçütlerini, belirtilen metni içermeyen 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 hides cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextDoesNotContain("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
textStringHücrenin içermemesi gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextEndsWith(text)

Filtre ölçütlerini, belirtilen metinle biten 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 ends with "est" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEndsWith("est")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
textStringHücre metninin sonunda yer alması gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextEqualTo(text)

Filtre ölçütlerini, belirtilen metne eşit 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 equals "hello" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualTo("hello")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
textStringHücredeki metnin eşit olması gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextEqualToAny(texts)

Filtre ölçütlerini, belirtilen metin değerlerinden herhangi birine eşit metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
textsString[]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 metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
textStringHücredeki metnin eşit olamayacağı metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextNotEqualToAny(texts)

Filtre ölçütlerini, belirtilen değerlerden hiçbirine eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable (DataSource sayfasından oluşturulmuş bir pivot tablo) ile kullanın.

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

AdTürAçıklama
textsString[]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

AdTürAçıklama
textStringHücre metninin başlangıcının içermesi gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


withCriteria(criteria, args)

Filtre ölçütlerini CELL_EMPTY veya NUMBER_GREATER_THAN gibi BooleanCriteria değerleriyle tanımlanan bir boole koşuluna ayarlar. Boole koşulunu mevcut ölçütlerden kopyalamak için mevcut ölçütlerde getCriteriaType() ve getCriteriaValues() kullanarak bu yöntemin parametrelerini tanımlayın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz, ancak bazı BooleanCriteria tüm filtreler için geçerli değildir.

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

AdTürAçıklama
criteriaBooleanCriteriaBoole ölçütlerinin türü.
argsObject[]Ölçüt türüne uygun bağımsız değişken dizisi. Bağımsız değişken sayısı ve türü, yukarıdaki ilgili when...() yöntemleriyle eşleşir.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.