Class FilterCriteriaBuilder

FiltreÖlçütOluşturucu

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

  1. SpreadsheetApp.newFilterCriteria() kullanarak ölçüt oluşturucuyu oluşturun.
  2. Bu sınıftaki yöntemleri kullanarak oluşturucuya ayar ekleyin.
  3. Belirttiğiniz ayarlarla ölçütleri bir araya getirmek için build() simgesini kullanın.

Yaygın kullanım alanları

Bir sayfadaki değerleri gizleme

Aşağıdaki örnek, bir sayfanın mevcut filtresini alır ve C sütununda "hello" veya "world" içeren hücreleri gizleyen ölçütler ekler. Bu örnekteki ölçütler yalnızca Grid sayfalarındaki filtrelerle (varsayılan sayfa türü) kullanılabilir.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const 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 filtre ekler. Bu sayfa, bir veritabanına bağlıdır ve yalnızca "Kategori" sütunundaki boş olmayan hücreleri gösteren ölçütlere sahiptir.
// Gets the sheet named "Connected sheet," which is connected to a database.
const sheet = SpreadsheetApp.getActiveSpreadsheet()
                  .getSheetByName('Connected sheet')
                  .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
const 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 bir araya getirir.
copy()FilterCriteriaBuilderBu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur.
getCriteriaType()BooleanCriteria|nullÖlçütün Boole türünü (ör. CELL_EMPTY) döndürür.
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|nullFiltre ölçütü olarak kullanılan arka plan rengini döndürür.
getVisibleForegroundColor()Color|nullFiltre ö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()FilterCriteriaBuilderBoş hücreleri göstermek için filtre ölçütlerini ayarlar.
whenCellNotEmpty()FilterCriteriaBuilderFiltre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar.
whenDateAfter(date)FilterCriteriaBuilderBelirtilen tarihten sonraki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateAfter(date)FilterCriteriaBuilderBelirtilen göreli tarihten sonraki tarihleri içeren hücreleri gösteren filtre ölçütleri ayarlar.
whenDateBefore(date)FilterCriteriaBuilderBelirtilen tarihten önceki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateBefore(date)FilterCriteriaBuilderBelirtilen göreli tarihten önceki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualTo(date)FilterCriteriaBuilderBelirtilen tarihe eşit olan tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualTo(date)FilterCriteriaBuilderBelirtilen göreli tarihe eşit olan tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualToAny(dates)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen tarihlerden herhangi birine eşit olan tarihleri içeren 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, belirtilen tarihlerden herhangi birine eşit olmayan tarihleri içeren hücreleri gösterecek şekilde ayarlar.
whenFormulaSatisfied(formula)FilterCriteriaBuilderFiltre ölçütlerini, true olarak değerlendirilen belirtilen bir formüle (ör. =B:B<C:C) sahip hücreleri gösterecek şekilde ayarlar.
whenNumberBetween(start, end)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen 2 sayı arasında olan veya bu sayılardan birini içeren hücreleri gösterecek şekilde ayarlar.
whenNumberEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıya eşit bir sayı içeren hücreleri gösterecek şekilde ayarlar.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayılardan herhangi birine eşit olan sayıların bulunduğu 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ıya eşit veya bu sayıdan büyük olan hücreleri gösterecek şekilde ayarlar.
whenNumberLessThan(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan küçük bir sayı içeren hücreleri gösterecek şekilde ayarlar.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan küçük veya bu sayıya eşit olan hücreleri gösterecek şekilde ayarlar.
whenNumberNotBetween(start, end)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen 2 sayı arasında olmayan ve bu sayılardan biri de olmayan hücreleri gösterecek şekilde ayarlar.
whenNumberNotEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıya eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayılardan herhangi birine eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar.
whenTextContains(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metni içeren metinlere sahip hücreleri gösterecek şekilde ayarlar.
whenTextDoesNotContain(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metni içermeyen metinlere sahip 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 olan 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 herhangi 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, BooleanCriteria değerleriyle tanımlanan bir boole koşuluna (ör. CELL_EMPTY veya NUMBER_GREATER_THAN) ayarlar.

Ayrıntılı belgeler

build()

Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini bir araya getirir.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const 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 gösterimi.


copy()

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

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

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
const 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çütlerine dayalı bir filtre ölçütü oluşturucu.


getCriteriaType()

Ölçütün Boole türünü (ör. CELL_EMPTY) döndürür. Boole ölçütü türleri hakkında bilgi edinmek için BooleanCriteria enum'ı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çütleri oluşturmak veya değiştirmek için ölçüt türünü ve ölçüt değerlerini kullanma hakkında bilgi edinmek için withCriteria(criteria, args) başlıklı makaleyi inceleyin.

Bu yöntemi herhangi bir filtre türü için kullanabilirsiniz. Filtre ölçütü bir Boole koşulu değilse null değerini döndürür.

const ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
const filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type
// object.
const criteriaType =
    filter.getColumnFilterCriteria(2).getCriteriaType().toString();
// Logs the criteria type.
console.log(criteriaType);

Return

BooleanCriteria|null: Boole ölçütünün türü veya ölçüt 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ürleri bağımsız değişken içermez ve boş bir dizi döndürür (ör. 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() kullanın.
  • Filtre ölçütleri oluşturmak veya değiştirmek için ölçüt türünü ve ölçüt değerlerini kullanma hakkında bilgi edinmek için withCriteria(criteria, args) başlıklı makaleyi inceleyin.

    Bu yöntemi herhangi bir filtre türü için kullanabilirsiniz.

    const ss = SpreadsheetApp.getActiveSheet();
    const 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.
    const 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ürü, when...() sınıfının ilgili FilterCriteriaBuilder yöntemiyle eşleşir.


getHiddenValues()

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

Bu ölçütü, varsayılan sayfa türü olan Grid sayfalarındaki filtrelerle kullanın. Diğer filtre türleri için bu yöntemi çağırırsanız null değerini döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

Return

String[]: Filtrenin gizlediği değerler 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çütü, varsayılan sayfa türü olan Grid sayfalarındaki filtrelerle kullanın. Diğer filtre türleri için bu yöntemi çağırırsanız null değerini döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the background color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

Return

Color|null: 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 kalır.

Bu ölçütü, varsayılan sayfa türü olan Grid sayfalarındaki filtrelerle kullanın. Diğer filtre türleri için bu yöntemi çağırırsanız null değerini döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the foreground color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

Return

Color|null: 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.

const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its
// first filter.
const pivotTable = ss.getPivotTables()[0];
const 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. Mevcut görünür veya gizli değerleri temizler.

Bu ölçütü 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
const 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 kullanılan bu oluşturucu.

Dekoratif yastıklar

Error: Değerlerden herhangi biri null ise.


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. Arka plan rengi filtre ölçütü ayarlamak, bu oluşturucudaki mevcut renk filtre ölçütlerini kaldırır.

Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const 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öntemde tema renkleri desteklenmez.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan 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 kalır. Ön plan rengi filtre ölçütü ayarlamak, bu oluşturucudaki mevcut renk filtresi ölçütlerini kaldırır.

Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const 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öntemde tema renkleri desteklenmez.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


setVisibleValues(values)

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

Bu ölçütü 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."
const pivotTable = ss.getPivotTables()[0];
const 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 kullanılan bu oluşturucu.

Dekoratif yastıklar

Error: Değerlerden herhangi biri null ise.


whenCellEmpty()

Boş hücreleri göstermek için filtre ölçütlerini ayarlar.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows empty cells.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenCellNotEmpty()

Filtre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows cells that aren't empty.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateAfter(date)

Belirtilen tarihten sonraki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria = SpreadsheetApp.newFilterCriteria().whenDateAfter(date).build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

AdTürAçıklama
dateDateGizlenecek en son tarih.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateAfter(date)

Belirtilen göreli tarihten sonraki tarihleri içeren hücreleri gösteren filtre ölçütleri ayarlar. Göreceli tarih seçeneklerini görüntülemek için Enum RelativeDate bölümüne bakın.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateBefore(date)

Belirtilen tarihten önceki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateBefore(date).build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

AdTürAçıklama
dateDateGizlenecek en erken tarih.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateBefore(date)

Belirtilen göreli tarihten önceki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar. Göreceli tarih seçeneklerini görüntülemek için Enum RelativeDate bölümüne bakın.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

AdTürAçıklama
dateRelativeDateGizlenecek en erken göreceli tarih.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateEqualTo(date)

Belirtilen tarihe eşit olan tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateEqualTo(date).build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateEqualTo(date)

Belirtilen göreli tarihe eşit olan tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar. Göreceli tarih seçeneklerini görüntülemek için Enum RelativeDate bölümüne bakın.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .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 kullanılan bu oluşturucu.


whenDateEqualToAny(dates)

Filtre ölçütlerini, belirtilen tarihlerden herhangi birine eşit olan tarihleri içeren hücreleri gösterecek şekilde ayarlar.

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const 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 kullanılan bu oluşturucu.


whenDateNotEqualTo(date)

Filtre ölçütlerini, belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar.

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

Filtrelediğiniz sütunun veri türü tarih olmalıdır.

// Gets a pivot table that's connected to a database.
const ss =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Pivot Table Sheet');
const dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
const date = new Date('June 16, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateNotEqualTo(date).build();
dataPivotTable.addFilter('date', criteria);

Parametreler

AdTürAçıklama
dateDateGizlenecek tarih.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenDateNotEqualToAny(dates)

Filtre ölçütlerini, belirtilen tarihlerden herhangi birine eşit olmayan tarihleri içeren hücreleri gösterecek şekilde ayarlar.

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateNotEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenFormulaSatisfied(formula)

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

Bu ölçütü yalnızca bir veritabanına bağlı olmayan verileri filtrelemek için kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const 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.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

AdTürAçıklama
formulaStringGiriş geçerliyse true olarak değerlendirilen özel bir formül.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenNumberBetween(start, end)

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

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25,
// inclusively, and sets it to column A.
const 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 kullanılan bu oluşturucu.


whenNumberEqualTo(number)

Filtre ölçütlerini, belirtilen sayıya eşit bir sayı içeren hücreleri gösterecek şekilde ayarlar.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberEqualTo(25).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenNumberEqualToAny(numbers)

Filtre ölçütlerini, belirtilen sayılardan herhangi birine eşit olan sayıların bulunduğu hücreleri gösterecek şekilde ayarlar.

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number
// 10, 20, or 30.
const 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 kullanılan 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çütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberGreaterThan(10).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenNumberGreaterThanOrEqualTo(number)

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

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to
// column B.
const 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 kullanılan bu oluşturucu.


whenNumberLessThan(number)

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

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberLessThan(10).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenNumberLessThanOrEqualTo(number)

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

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to
// column B.
const 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 kullanılan bu oluşturucu.


whenNumberNotBetween(start, end)

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

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25,
// inclusively, and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberNotBetween(1, 25).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
startNumberEn düşük sayı gizleme.
endNumberGizlenecek en yüksek sayı.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan 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çütü herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column
// B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberNotEqualTo(25).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
numberNumberGizlenecek sayı.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenNumberNotEqualToAny(numbers)

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

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20,
// or 30.
const 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 kullanılan bu oluşturucu.


whenTextContains(text)

Filtre ölçütlerini, belirtilen metni içeren metinlere sahip hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to
// column B.
const 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 kullanılan bu oluşturucu.


whenTextDoesNotContain(text)

Filtre ölçütlerini, belirtilen metni içermeyen metinlere sahip hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.

Bu ölçütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to
// column B.
const 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 kullanılan 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çütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it
// to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextEndsWith('est').build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

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

Return

FilterCriteriaBuilder: Zincirleme için kullanılan 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çütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it
// to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextEqualTo('hello').build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
textStringHücre metninin eşit olması gereken metin.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenTextEqualToAny(texts)

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

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech"
// or "business."
const 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 kullanılan 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çütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to
// "tech."
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextNotEqualTo('tech').build();
dataSheet.addFilter('category', criteria);

Parametreler

AdTürAçıklama
textStringHücre metninin eşit olamayacağı metin.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


whenTextNotEqualToAny(texts)

Filtre ölçütlerini, belirtilen değerlerden herhangi 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çütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütü DataSource sayfasındaki, bir veritabanına bağlı olan bir sayfadaki veya DataSource sayfasından oluşturulan bir özet tablodaki DataSourcePivotTable filtrelerle birlikte kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech"
// or "business."
const 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 kullanılan 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çütü herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets
// it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextStartsWith('pre').build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

AdTürAçıklama
textStringHücre metninin başlangıcında bulunması gereken metin.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.


withCriteria(criteria, args)

Filtre ölçütlerini, BooleanCriteria değerleriyle tanımlanan bir boole koşuluna (ör. CELL_EMPTY veya NUMBER_GREATER_THAN) 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çütü her tür filtreyle 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();
const 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."
const filterCriteria = filter.getColumnFilterCriteria(2);
const 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 bir dizi bağımsız değişken. Bağımsız değişkenlerin sayısı ve türü, yukarıdaki ilgili when...() yöntemleriyle eşleşir.

Return

FilterCriteriaBuilder: Zincirleme için kullanılan bu oluşturucu.