Class FilterCriteriaBuilder

FilterCriteriaBuilder

Untuk menambahkan kriteria ke filter, Anda harus melakukan hal berikut:

1. Buat pembuat kriteria menggunakan SpreadsheetApp.newFilterCriteria().
2. Tambahkan setelan ke builder menggunakan metode dari class ini.
3. Gunakan build() untuk menyusun kriteria dengan setelan yang Anda tentukan.

Penggunaan umum

Menyembunyikan nilai di sheet

Contoh berikut mendapatkan filter yang ada pada sheet dan menambahkan kriteria yang menyembunyikan sel di kolom C yang berisi "hello" atau "world". Kriteria dalam contoh ini hanya dapat digunakan dengan filter pada sheet Grid, yaitu jenis sheet default.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["hello", "world"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Hanya tampilkan sel yang tidak kosong

Contoh berikut menambahkan filter ke sheet DataSource, sheet yang terhubung ke database, dengan kriteria yang hanya menampilkan sel-sel di kolom "Category" yang tidak kosong.

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

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
build()	FilterCriteria	Mengumpulkan kriteria filter menggunakan setelan yang Anda tambahkan ke pembuat kriteria.
copy()	FilterCriteriaBuilder	Menyalin kriteria filter ini dan membuat builder kriteria yang dapat Anda terapkan ke filter lain.
getCriteriaType()	BooleanCriteria	Menampilkan jenis boolean kriteria, misalnya, CELL_EMPTY.
getCriteriaValues()	Object[]	Menampilkan array argumen untuk kriteria boolean.
getHiddenValues()	String[]	Menampilkan nilai yang disembunyikan filter.
getVisibleBackgroundColor()	Color	Menampilkan warna latar belakang yang digunakan sebagai kriteria filter.
getVisibleForegroundColor()	Color	Menampilkan warna latar depan yang digunakan sebagai kriteria filter.
getVisibleValues()	String[]	Menampilkan nilai yang ditampilkan oleh filter tabel pivot.
setHiddenValues(values)	FilterCriteriaBuilder	Menetapkan nilai yang akan disembunyikan.
setVisibleBackgroundColor(visibleBackgroundColor)	FilterCriteriaBuilder	Menetapkan warna latar belakang yang digunakan sebagai kriteria filter.
setVisibleForegroundColor(visibleForegroundColor)	FilterCriteriaBuilder	Menetapkan warna latar depan yang digunakan sebagai kriteria filter.
setVisibleValues(values)	FilterCriteriaBuilder	Menetapkan nilai yang akan ditampilkan pada tabel pivot.
whenCellEmpty()	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel kosong.
whenCellNotEmpty()	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel yang tidak kosong.
whenDateAfter(date)	FilterCriteriaBuilder	Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang jatuh setelah tanggal yang ditentukan.
whenDateAfter(date)	FilterCriteriaBuilder	Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang melebihi tanggal relatif yang ditentukan.
whenDateBefore(date)	FilterCriteriaBuilder	Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang jatuh sebelum tanggal yang ditentukan.
whenDateBefore(date)	FilterCriteriaBuilder	Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang jatuh sebelum tanggal relatif yang ditentukan.
whenDateEqualTo(date)	FilterCriteriaBuilder	Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal yang ditentukan.
whenDateEqualTo(date)	FilterCriteriaBuilder	Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal relatif yang ditentukan.
whenDateEqualToAny(dates)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan tanggal yang sama dengan salah satu tanggal yang ditentukan.
whenDateNotEqualTo(date)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel yang tidak sama dengan tanggal yang ditentukan.
whenDateNotEqualToAny(dates)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan tanggal yang tidak sama dengan salah satu tanggal yang ditentukan.
whenFormulaSatisfied(formula)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan formula tertentu (seperti =B:B<C:C) yang bernilai true.
whenNumberBetween(start, end)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang berada di antara, atau merupakan salah satu dari, 2 angka yang ditentukan.
whenNumberEqualTo(number)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan angka yang ditentukan.
whenNumberEqualToAny(numbers)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan salah satu angka yang ditentukan.
whenNumberGreaterThan(number)	FilterCriteriaBuilder	Menyetel kriteria filter untuk menampilkan sel dengan angka yang lebih besar dari angka yang ditentukan
whenNumberGreaterThanOrEqualTo(number)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih besar dari atau sama dengan angka yang ditentukan.
whenNumberLessThan(number)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih kecil dari angka yang ditentukan.
whenNumberLessThanOrEqualTo(number)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih kecil dari atau sama dengan angka yang ditentukan.
whenNumberNotBetween(start, end)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak berada di antara, dan bukan salah satu dari, 2 angka yang ditentukan.
whenNumberNotEqualTo(number)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka yang ditentukan.
whenNumberNotEqualToAny(numbers)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka mana pun yang ditentukan.
whenTextContains(text)	FilterCriteriaBuilder	Menyetel kriteria filter untuk menampilkan sel dengan teks yang berisi teks tertentu.
whenTextDoesNotContain(text)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak berisi teks tertentu.
whenTextEndsWith(text)	FilterCriteriaBuilder	Menyetel kriteria filter untuk menampilkan sel dengan teks yang diakhiri dengan teks yang ditentukan.
whenTextEqualTo(text)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel berisi teks yang sama dengan teks yang ditentukan.
whenTextEqualToAny(texts)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan teks yang sama dengan salah satu nilai teks yang ditentukan.
whenTextNotEqualTo(text)	FilterCriteriaBuilder	Menyetel kriteria filter untuk menampilkan sel berisi teks yang tidak sama dengan teks yang ditentukan.
whenTextNotEqualToAny(texts)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak sama dengan salah satu nilai yang ditentukan.
whenTextStartsWith(text)	FilterCriteriaBuilder	Menetapkan kriteria filter untuk menampilkan sel dengan teks yang dimulai dengan teks yang ditentukan.
withCriteria(criteria, args)	FilterCriteriaBuilder	Menetapkan kriteria filter ke kondisi boolean yang ditentukan oleh nilai BooleanCriteria, seperti CELL_EMPTY atau NUMBER_GREATER_THAN.

Dokumentasi mendetail

build()

Mengumpulkan kriteria filter menggunakan setelan yang Anda tambahkan ke pembuat kriteria.

// 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 — Representasi kriteria filter.

---

copy()

Menyalin kriteria filter ini dan membuat builder kriteria yang dapat Anda terapkan ke filter lain.

Anda dapat menggunakan metode ini dengan jenis filter apa pun. Jika Anda menggunakan filter {i>sheet<i}, Anda dapat menyalin kriteria ke kolom lain.

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 — Pembuat kriteria filter berdasarkan kriteria filter ini.

---

getCriteriaType()

Menampilkan jenis boolean kriteria, misalnya, CELL_EMPTY. Untuk mempelajari jenis kriteria boolean, lihat enum BooleanCriteria.

Pengguna sering menggunakan metode ini untuk menambahkan kriteria kondisi boolean ke filter tanpa mengganti kriteria yang ada.

• Untuk mendapatkan argumen bagi kriteria, gunakan getCriteriaValues().
• Untuk menggunakan jenis kriteria dan nilai kriteria guna membuat atau mengubah kriteria filter, lihat withCriteria(criteria, args).

Anda dapat menggunakan metode ini untuk semua jenis filter. Jika kriteria filter bukan kondisi boolean, tampilkan null.

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

Return

BooleanCriteria — Jenis kriteria boolean, atau null jika kriteria bukan kondisi boolean.

---

getCriteriaValues()

Menampilkan array argumen untuk kriteria boolean. Beberapa jenis kriteria boolean tidak memiliki argumen dan menampilkan array kosong, misalnya CELL_NOT_EMPTY.

Pengguna sering menggunakan metode ini untuk menambahkan kriteria kondisi boolean ke filter tanpa mengganti kriteria yang ada.

• Untuk mendapatkan jenis kriteria boolean, gunakan getCriteriaType().
• Untuk menggunakan jenis kriteria dan nilai kriteria guna membuat atau memodifikasi kriteria filter, lihat withCriteria(criteria, args).

  Anda dapat menggunakan metode ini untuk semua jenis filter.

  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[] — Array argumen yang sesuai dengan jenis kriteria boolean. Jumlah argumen dan jenisnya cocok dengan metode when...() class FilterCriteriaBuilder yang sesuai.

---

getHiddenValues()

Menampilkan nilai yang disembunyikan filter.

Gunakan kriteria ini dengan filter pada sheet Grid, yang merupakan jenis sheet default. Menampilkan null jika Anda memanggil metode ini untuk jenis filter lain.

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[] — Array nilai yang disembunyikan filter.

---

getVisibleBackgroundColor()

Menampilkan warna latar belakang yang digunakan sebagai kriteria filter. Sel dengan warna latar belakang ini tetap terlihat.

Gunakan kriteria ini dengan filter pada sheet Grid, yang merupakan jenis sheet default. Menampilkan null jika Anda memanggil metode ini untuk jenis filter lain.

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 — Warna latar belakang yang digunakan sebagai kriteria filter.

---

getVisibleForegroundColor()

Menampilkan warna latar depan yang digunakan sebagai kriteria filter. Sel dengan warna latar depan ini tetap terlihat.

Gunakan kriteria ini dengan filter pada sheet Grid, yang merupakan jenis sheet default. Menampilkan null jika Anda memanggil metode ini untuk jenis filter lain.

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 — Warna latar depan yang digunakan sebagai kriteria filter.

---

getVisibleValues()

Menampilkan nilai yang ditampilkan oleh filter tabel pivot.

Kriteria ini hanya untuk filter pada tabel pivot yang tidak terhubung ke database. Menampilkan array kosong untuk jenis filter lainnya.

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[] — Array nilai yang ditampilkan oleh filter tabel pivot.

---

setHiddenValues(values)

Menetapkan nilai yang akan disembunyikan. Menghapus semua nilai yang terlihat atau tersembunyi yang ada.

Anda hanya dapat menggunakan kriteria ini untuk filter pada sheet Grid, yang merupakan jenis default sheet.

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

Parameter

Nama	Jenis	Deskripsi
values	String[]	Daftar nilai yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

setVisibleBackgroundColor(visibleBackgroundColor)

Menetapkan warna latar belakang yang digunakan sebagai kriteria filter. Sel dengan warna latar belakang ini tetap terlihat. Menetapkan kriteria filter warna latar belakang akan menghapus kriteria filter warna saat ini dari builder ini.

Anda hanya dapat menggunakan kriteria ini untuk filter pada sheet Grid, yang merupakan jenis default sheet.

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

Parameter

Nama	Jenis	Deskripsi
visibleBackgroundColor	Color	Warna latar belakang yang akan ditetapkan. Warna harus berupa warna gaya RGB. Metode ini tidak mendukung warna tema.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

setVisibleForegroundColor(visibleForegroundColor)

Menetapkan warna latar depan yang digunakan sebagai kriteria filter. Sel dengan warna latar depan ini tetap terlihat. Menetapkan kriteria filter warna latar depan akan menghapus kriteria filter warna saat ini dari builder ini.

Anda hanya dapat menggunakan kriteria ini untuk filter pada sheet Grid, yang merupakan jenis default sheet.

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

Parameter

Nama	Jenis	Deskripsi
visibleForegroundColor	Color	Warna latar depan yang akan ditetapkan. Warna harus berupa warna gaya RGB. Metode ini tidak mendukung warna tema.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

setVisibleValues(values)

Menetapkan nilai yang akan ditampilkan pada tabel pivot. Menghapus semua nilai yang terlihat atau tersembunyi yang ada.

Anda hanya dapat menggunakan kriteria ini untuk filter pada tabel pivot yang tidak terhubung ke database.

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

Parameter

Nama	Jenis	Deskripsi
values	String[]	Daftar nilai yang akan ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenCellEmpty()

Menetapkan kriteria filter untuk menampilkan sel kosong.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

// 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 — Builder ini untuk membuat rantai.

---

whenCellNotEmpty()

Menetapkan kriteria filter untuk menampilkan sel yang tidak kosong.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

// 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 — Builder ini untuk membuat rantai.

---

whenDateAfter(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang jatuh setelah tanggal yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang difilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa tanggal. Namun, jika tidak terhubung, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
date	Date	Tanggal terbaru yang disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateAfter(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang melebihi tanggal relatif yang ditentukan. Untuk melihat opsi tanggal relatif, lihat Enum RelativeDate.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang difilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa tanggal. Namun, jika tidak terhubung, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
date	RelativeDate	Tanggal relatif terakhir.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateBefore(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang jatuh sebelum tanggal yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang difilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa tanggal. Namun, jika tidak terhubung, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
date	Date	Tanggal paling awal yang disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateBefore(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang jatuh sebelum tanggal relatif yang ditentukan. Untuk melihat opsi tanggal relatif, lihat Enum RelativeDate.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang difilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa tanggal. Namun, jika tidak terhubung, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
date	RelativeDate	Tanggal relatif paling awal yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateEqualTo(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang difilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa tanggal. Namun, jika tidak terhubung, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
date	Date	Tanggal saat nilai sel harus cocok.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateEqualTo(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal relatif yang ditentukan. Untuk melihat opsi tanggal relatif, lihat Enum RelativeDate.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang difilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa tanggal. Namun, jika tidak terhubung, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
date	RelativeDate	Tanggal relatif saat nilai sel harus cocok.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateEqualToAny(dates)

Menetapkan kriteria filter untuk menampilkan sel dengan tanggal yang sama dengan salah satu tanggal yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

Nama	Jenis	Deskripsi
dates	Date[]	Tanggal yang ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateNotEqualTo(date)

Menetapkan kriteria filter untuk menampilkan sel yang tidak sama dengan tanggal yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

Jenis data kolom yang Anda filter harus berupa tanggal.

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

Parameter

Nama	Jenis	Deskripsi
date	Date	Tanggal yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenDateNotEqualToAny(dates)

Menetapkan kriteria filter untuk menampilkan sel dengan tanggal yang tidak sama dengan salah satu tanggal yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

Nama	Jenis	Deskripsi
dates	Date[]	Tanggal yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenFormulaSatisfied(formula)

Menetapkan kriteria filter untuk menampilkan sel dengan formula tertentu (seperti =B:B<C:C) yang bernilai true.

Anda hanya dapat menggunakan kriteria ini untuk memfilter data yang tidak terhubung ke {i>database<i}.

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

Parameter

Nama	Jenis	Deskripsi
formula	String	Formula kustom yang bernilai true jika inputnya valid.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberBetween(start, end)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang berada di antara, atau merupakan salah satu dari, 2 angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
start	Number	Angka terendah yang akan ditampilkan.
end	Number	Angka tertinggi yang akan ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
number	Number	Angka yang akan ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberEqualToAny(numbers)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan salah satu angka yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number 10, 20, or 30.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberEqualToAny([10,20,30])
                             .build();
dataSheet.addFilter("amount", criteria);

Parameter

Nama	Jenis	Deskripsi
numbers	Number[]	Angka yang akan ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberGreaterThan(number)

Menyetel kriteria filter untuk menampilkan sel dengan angka yang lebih besar dari angka yang ditentukan

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
number	Number	Angka tertinggi untuk disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberGreaterThanOrEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih besar dari atau sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
number	Number	Angka terendah yang akan ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberLessThan(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih kecil dari angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
number	Number	Angka terendah yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberLessThanOrEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih kecil dari atau sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
number	Number	Angka tertinggi yang akan ditampilkan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberNotBetween(start, end)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak berada di antara, dan bukan salah satu dari, 2 angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
start	Number	Angka terendah akan disembunyikan.
end	Number	Angka tertinggi untuk disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberNotEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda filter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak perlu berupa angka, tetapi jika tidak, Anda mungkin akan mendapatkan hasil yang tidak diharapkan.

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

Parameter

Nama	Jenis	Deskripsi
number	Number	Angka yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenNumberNotEqualToAny(numbers)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka mana pun yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20, or 30.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotEqualToAny([10,20,30])
                             .build();
dataSheet.addFilter("amount", criteria);

Parameter

Nama	Jenis	Deskripsi
numbers	Number[]	Angka yang akan disembunyikan.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextContains(text)

Menyetel kriteria filter untuk menampilkan sel dengan teks yang berisi teks tertentu. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

Nama	Jenis	Deskripsi
text	String	Teks yang harus dimuat dalam sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextDoesNotContain(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak berisi teks tertentu. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

Nama	Jenis	Deskripsi
text	String	Teks yang tidak boleh dimuat dalam sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextEndsWith(text)

Menyetel kriteria filter untuk menampilkan sel dengan teks yang diakhiri dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

Nama	Jenis	Deskripsi
text	String	Teks yang harus dimuat di akhir teks sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextEqualTo(text)

Menetapkan kriteria filter untuk menampilkan sel berisi teks yang sama dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

Nama	Jenis	Deskripsi
text	String	Teks yang harus sama dengan teks sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextEqualToAny(texts)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang sama dengan salah satu nilai teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parameter

Nama	Jenis	Deskripsi
texts	String[]	Nilai teks yang harus sama dengan sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextNotEqualTo(text)

Menyetel kriteria filter untuk menampilkan sel berisi teks yang tidak sama dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

Nama	Jenis	Deskripsi
text	String	Teks yang tidak dapat disamakan oleh teks sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextNotEqualToAny(texts)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak sama dengan salah satu nilai yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke {i>database<i}. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

Nama	Jenis	Deskripsi
texts	String[]	Nilai teks yang tidak dapat sama dengan sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

whenTextStartsWith(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang dimulai dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

Nama	Jenis	Deskripsi
text	String	Teks yang harus dimuat di awal teks sel.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.

---

withCriteria(criteria, args)

Menetapkan kriteria filter ke kondisi boolean yang ditentukan oleh nilai BooleanCriteria, seperti CELL_EMPTY atau NUMBER_GREATER_THAN. Untuk menyalin kondisi boolean dari kriteria yang ada, tentukan parameter untuk metode ini menggunakan getCriteriaType() dan getCriteriaValues() pada kriteria yang ada.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun, tetapi beberapa BooleanCriteria tidak berlaku untuk semua filter.

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

Parameter

Nama	Jenis	Deskripsi
criteria	BooleanCriteria	Jenis kriteria boolean.
args	Object[]	Array argumen yang sesuai dengan jenis kriteria tersebut; jumlah argumen dan jenisnya cocok dengan metode when...() yang sesuai di atas.

Return

FilterCriteriaBuilder — Builder ini untuk membuat rantai.