Class FilterCriteriaBuilder

הכלי הזה מרכיב את קריטריונים הסינון על סמך ההגדרות שאתם מוסיפים לכלי ליצירת קריטריונים.

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

חזרה

FilterCriteria — ייצוג של קריטריוני הסינון.

מעתיק את קריטריוני הסינון האלה ויוצר כלי ליצירת קריטריונים שאפשר להחיל על מסנן אחר.

אפשר להשתמש בשיטה הזו עם כל סוג של מסנן. אם משתמשים במסנן גיליון, אפשר להעתיק את הקריטריונים לעמודה אחרת.

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

חזרה

FilterCriteriaBuilder – כלי ליצירת קריטריונים לסינון על סמך קריטריוני הסינון האלה.

הפונקציה מחזירה את הסוג הבוליאני של הקריטריון, לדוגמה, CELL_EMPTY. מידע נוסף על סוגי הקריטריונים הבוליאניים זמין ב-enum‏ BooleanCriteria.

אנשים משתמשים בשיטה הזו לעיתים קרובות כדי להוסיף קריטריונים של תנאים בוליאניים למסנן בלי להחליף קריטריונים קיימים.

• כדי לקבל את הארגומנטים של הקריטריונים, משתמשים ב-getCriteriaValues().
• במאמר withCriteria(criteria, args) מוסבר איך משתמשים בסוג הקריטריונים ובערכים שלהם כדי ליצור או לשנות קריטריונים לסינון.

אפשר להשתמש בשיטה הזו בכל סוג של מסנן. אם קריטריון הסינון הוא לא תנאי בוליאני, הפונקציה מחזירה את הערך null.

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

חזרה

BooleanCriteria — הסוג של הקריטריון הבוליאני, או null אם הקריטריון הוא לא תנאי בוליאני.

הפונקציה מחזירה מערך של ארגומנטים לקריטריונים בוליאניים. לחלק מסוגי הקריטריונים הבוליאניים אין ארגומנטים והם מחזירים מערך ריק, לדוגמה, CELL_NOT_EMPTY.

אנשים משתמשים בשיטה הזו לעיתים קרובות כדי להוסיף קריטריונים של תנאים בוליאניים למסנן בלי להחליף קריטריונים קיימים.

• כדי לקבל את סוג הקריטריון הבוליאני, משתמשים ב-getCriteriaType().
• כדי להשתמש בסוג הקריטריונים ובערכים של הקריטריונים ליצירה או לשינוי של קריטריון סינון, קראו את המאמר withCriteria(criteria, args).

  אפשר להשתמש בשיטה הזו בכל סוג של מסנן.

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

  חזרה

  Object[] – מערך של ארגומנטים שמתאימים לסוג הקריטריון הבוליאני. מספר הארגומנטים והסוג שלהם תואמים לשיטה when...() המתאימה של הכיתה FilterCriteriaBuilder.

הפונקציה מחזירה את הערכים שהמסנן מסתיר.

משתמשים בקריטריונים האלה עם מסננים בגיליון Grid, סוג ברירת המחדל של גיליון. הפונקציה מחזירה את הערך null אם קוראים לה לסוגים אחרים של מסננים.

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

חזרה

String[] – מערך של ערכים שהמסנן מסתיר.

הפונקציה מחזירה את צבע הרקע שמשמש כקריטריון סינון. תאים עם צבע הרקע הזה יישארו גלויים.

משתמשים בקריטריונים האלה עם מסננים בגיליון Grid, סוג ברירת המחדל של גיליון. הפונקציה מחזירה את הערך null אם קוראים לה לסוגים אחרים של מסננים.

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

חזרה

Color — צבע הרקע שמשמש כקריטריון סינון.

הפונקציה מחזירה את צבע החזית שמשמש כקריטריון סינון. תאים עם צבע החזית הזה יישארו גלויים.

משתמשים בקריטריונים האלה עם מסננים בגיליון Grid, סוג ברירת המחדל של גיליון. הפונקציה מחזירה את הערך null אם קוראים לה לסוגים אחרים של מסננים.

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

חזרה

Color — צבע החזית שמשמש כקריטריון סינון.

הפונקציה מחזירה את הערכים שמוצגים במסנן של טבלת הצירים.

הקריטריונים האלה רלוונטיים רק למסננים בטבלאות צירים שלא מקושרות למסד נתונים. עבור סוגי מסננים אחרים, הפונקציה מחזירה מערך ריק.

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

חזרה

String[] – מערך של ערכים שמוצגים במסנן של טבלת הצירים.

הגדרת הערכים להסתרה. ניקוי של ערכים קיימים, גלויים או מוסתרים.

אפשר להשתמש בקריטריונים האלה רק במסננים של גיליונות Grid, סוג הגיליונות שמוגדר כברירת מחדל.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

זריקות

Error – אם אחד מהערכים הוא null.

הגדרת צבע הרקע שמשמש כקריטריון לסינון. תאים עם צבע הרקע הזה יישארו גלויים. הגדרת קריטריונים לסינון לפי צבע רקע מסירה מה-builder הזה את כל הקריטריונים הנוכחיים לסינון לפי צבע.

אפשר להשתמש בקריטריונים האלה רק במסננים של גיליונות Grid, סוג הגיליונות שמוגדר כברירת מחדל.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת צבע החזית שישמש כקריטריון סינון. תאים עם צבע החזית הזה יישארו גלויים. הגדרת קריטריונים של מסנן צבע חזית מסירה את כל הקריטריונים הנוכחיים של מסנן הצבע מהכלי הזה.

אפשר להשתמש בקריטריונים האלה רק במסננים של גיליונות Grid, סוג הגיליונות שמוגדר כברירת מחדל.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת הערכים שיוצגו בטבלת צירים. ניקוי של ערכים קיימים, גלויים או מוסתרים.

אפשר להשתמש בקריטריונים האלה רק במסננים בטבלאות צירים שלא מחוברות למסד נתונים.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

זריקות

Error – אם אחד מהערכים הוא null.

מגדיר את קריטריוני הסינון כך שיוצגו תאים ריקים.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים שאינם ריקים.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שמאוחרים יותר מהתאריך שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מבצעים את הסינון חייב להיות תאריך. אם הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות תאריך, אבל אם הוא לא תאריך, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שמגיעים אחרי התאריך היחסי שצוין. אפשרויות התאריכים היחסיים מפורטות במאמר Enum RelativeDate.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מבצעים את הסינון חייב להיות תאריך. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות תאריך, אבל אם הוא לא תאריך, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שקדמו לתאריך שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מבצעים את הסינון חייב להיות תאריך. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות תאריך, אבל אם הוא לא תאריך, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שקדמו לתאריך היחסי שצוין. אפשרויות התאריך היחסי מפורטות במאמר Enum RelativeDate.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מבצעים את הסינון חייב להיות תאריך. אם הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות תאריך, אבל אם הוא לא תאריך, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שווים לתאריך שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מבצעים את הסינון חייב להיות תאריך. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות תאריך, אבל אם הוא לא תאריך, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שווים לתאריך היחסי שצוין. אפשרויות התאריך היחסי מפורטות במאמר Enum RelativeDate.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מבצעים את הסינון חייב להיות תאריך. אם הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות תאריך, אבל אם הוא לא תאריך, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים של מסנן כדי להציג תאים עם תאריכים שווים לאחד מהתאריכים שצוינו.

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים למסנן כדי להציג תאים שלא שווים לתאריך שצוין.

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

סוג הנתונים של העמודה שבה אתם מסננים חייב להיות תאריך.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים של מסנן כדי להציג תאים עם תאריכים שלא זהים לאף אחד מהתאריכים שצוינו.

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

מגדיר את קריטריונים הסינון כך שיוצגו תאים עם נוסחה ספציפית (למשל =B:B<C:C) שמתקבל ממנה הערך true.

אפשר להשתמש בקריטריונים האלה רק כדי לסנן נתונים שלא מקושרים למסד נתונים.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כדי להציג תאים עם מספר שנמצא בין שני מספרים ספציפיים, או שהוא אחד משני המספרים האלה.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים של מסנן כדי להציג תאים עם מספר שווה למספר שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם מספר שווה לאחד מהמספרים שצוינו.

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם מספר גדול מהמספר שצוין

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם מספר גדול מ- או שווה ל-.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריון הסינון כך שיוצגו תאים עם מספר שקטן מהמספר שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם מספר שקטן מ- או שווה ל-.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם מספר שאינו נמצא בין שני מספרים ספציפיים, ולא אחד משני המספרים האלה.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים של מסנן כדי להציג תאים עם מספר שאינו שווה למספר שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם משתמשים בקריטריון הזה עם נתונים שמחוברים למסד נתונים, סוג הנתונים של העמודה שבה מתבצע הסינון חייב להיות מספר. אם הנתונים לא מחוברים למסד נתונים, סוג הנתונים של העמודה שבה אתם מסננים לא חייב להיות מספר, אבל אם הוא לא מספר, יכול להיות שתקבלו תוצאות לא צפויות.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים של מסנן להצגת תאים עם מספר שאינו שווה לאף אחד מהמספרים שצוינו.

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כדי להציג תאים עם טקסט שמכיל את הטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כדי להציג תאים עם טקסט שלא מכיל את הטקסט שצוין. הטקסט לא תלוי אותיות רישיות.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם טקסט שמסתיים בטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כדי להציג תאים עם טקסט שווה לטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם טקסט שווה לאחד מערכי הטקסט שצוינו. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כדי להציג תאים עם טקסט שלא שווה לטקסט שצוין. הטקסט לא תלוי אותיות רישיות.

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם טקסט שלא שווה לאף אחד מהערכים שצוינו. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון DataSource, בגיליון שמקושר למסד נתונים או ב-DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון כך שיוצגו תאים עם טקסט שמתחיל בטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.

הגדרת קריטריונים לסינון לפי תנאי בוליאני שמוגדר על ידי ערכים של BooleanCriteria, כמו CELL_EMPTY או NUMBER_GREATER_THAN. כדי להעתיק את התנאי הבוליאני מקריטריונים קיימים, מגדירים את הפרמטרים של השיטה הזו באמצעות getCriteriaType() ו-getCriteriaValues() בקריטריונים קיימים.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן, אבל חלק מה-BooleanCriteria לא רלוונטיים לכל המסננים.

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

פרמטרים

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשור.