Class FilterCriteriaBuilder

FilterCriteriaBuilder

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

  1. יוצרים את הכלי ליצירת קריטריונים באמצעות SpreadsheetApp.newFilterCriteria().
  2. מוסיפים הגדרות לכלי הבנייה באמצעות השיטות מהמחלקה הזו.
  3. משתמשים ב-build() כדי להרכיב את הקריטריונים עם ההגדרות שצוינו.

שימושים נפוצים

הסתרת ערכים בגיליון

בדוגמה הבאה מקבלים את המסנן הקיים של גיליון ומוסיפים קריטריונים להסתרה של התאים בעמודה C שמכילים את הערכים hello או world. אפשר להשתמש בקריטריונים שבמדגם הזה רק עם מסננים בגיליונות Grid, סוג הגיליון שמוגדר כברירת מחדל. 
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['hello', 'world'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

הצגה רק של תאים לא ריקים

בדוגמה הבאה מוסיפים מסנן לגיליון DataSource, גיליון שמחובר למסד נתונים, עם קריטריונים שמציגים רק תאים בעמודה 'קטגוריה' שלא ריקים. 
// 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);

Methods

שיטהסוג הערך שמוחזרתיאור קצר
build()FilterCriteriaהכלי להגדרת קריטריונים מרכיב את קריטריוני הסינון לפי ההגדרות שאתם מוסיפים.
copy()FilterCriteriaBuilderמעתין את קריטריוני הסינון האלה ויוצר כלי ליצירת קריטריונים שאפשר להחיל על מסנן אחר.
getCriteriaType()BooleanCriteria|nullהפונקציה מחזירה את הסוג הבוליאני של הקריטריון, לדוגמה, CELL_EMPTY.
getCriteriaValues()Object[]מחזירה מערך של ארגומנטים לקריטריונים בוליאניים.
getHiddenValues()String[]מחזירה את הערכים שהמסנן מסתיר.
getVisibleBackgroundColor()Color|nullהפונקציה מחזירה את צבע הרקע שמשמש כקריטריון סינון.
getVisibleForegroundColor()Color|nullהפונקציה מחזירה את צבע החזית שמשמש כקריטריון סינון.
getVisibleValues()String[]הפונקציה מחזירה את הערכים שמוצגים במסנן של טבלת הצירים.
setHiddenValues(values)FilterCriteriaBuilderמגדירים את הערכים להסתרה.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderהגדרת צבע הרקע שמשמש כקריטריון לסינון.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderהגדרת צבע החזית שמשמש כקריטריון לסינון.
setVisibleValues(values)FilterCriteriaBuilderהגדרה של הערכים שיוצגו בטבלת צירים.
whenCellEmpty()FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים ריקים.
whenCellNotEmpty()FilterCriteriaBuilderהגדרת קריטריונים לסינון כדי להציג תאים שלא ריקים.
whenDateAfter(date)FilterCriteriaBuilderהגדרת קריטריוני סינון להצגת תאים עם תאריכים שמאוחרים לתאריך שצוין.
whenDateAfter(date)FilterCriteriaBuilderהגדרת קריטריונים של מסנן שמציג תאים עם תאריכים שחלים אחרי התאריך היחסי שצוין.
whenDateBefore(date)FilterCriteriaBuilderהגדרת קריטריונים לסינון שמציגים תאים עם תאריכים שקודמים לתאריך שצוין.
whenDateBefore(date)FilterCriteriaBuilderהגדרת קריטריוני סינון שמציגים תאים עם תאריכים שקודמים לתאריך היחסי שצוין.
whenDateEqualTo(date)FilterCriteriaBuilderהגדרת קריטריונים לסינון שמציגים תאים עם תאריכים ששווים לתאריך שצוין.
whenDateEqualTo(date)FilterCriteriaBuilderהגדרת קריטריונים לסינון שמציגים תאים עם תאריכים ששווים לתאריך היחסי שצוין.
whenDateEqualToAny(dates)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם תאריכים ששווים לאחד מהתאריכים שצוינו.
whenDateNotEqualTo(date)FilterCriteriaBuilderהגדרת קריטריוני המסנן להצגת תאים שלא שווים לתאריך שצוין.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderהגדרת קריטריוני המסנן להצגת תאים עם תאריכים שלא שווים לאף אחד מהתאריכים שצוינו.
whenFormulaSatisfied(formula)FilterCriteriaBuilderמגדיר את קריטריוני הסינון להצגת תאים עם נוסחה שצוינה (למשל =B:B<C:C) שהערך שלה הוא true.
whenNumberBetween(start, end)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם מספר שנמצא בין שני מספרים שצוינו, או ששווה לאחד מהם.
whenNumberEqualTo(number)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם מספר ששווה למספר שצוין.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם מספר ששווה לאחד מהמספרים שצוינו.
whenNumberGreaterThan(number)FilterCriteriaBuilderהגדרת קריטריון לסינון כדי להציג תאים עם מספר שגדול מהמספר שצוין
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם מספר שגדול ממספר מסוים או שווה לו.
whenNumberLessThan(number)FilterCriteriaBuilderהגדרת קריטריון הסינון להצגת תאים עם מספר שקטן מהמספר שצוין.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderהגדרה של קריטריוני הסינון להצגת תאים עם מספר שקטן ממספר מסוים או שווה לו.
whenNumberNotBetween(start, end)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם מספר שלא נמצא בין שני מספרים שצוינו, ולא שווה לאף אחד מהם.
whenNumberNotEqualTo(number)FilterCriteriaBuilderהגדרה של קריטריוני הסינון להצגת תאים עם מספר שלא שווה למספר שצוין.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderהגדרת קריטריוני המסנן להצגת תאים עם מספר שלא שווה לאף אחד מהמספרים שצוינו.
whenTextContains(text)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט שמכיל את הטקסט שצוין.
whenTextDoesNotContain(text)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט שלא מכיל את הטקסט שצוין.
whenTextEndsWith(text)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט שמסתיים בטקסט שצוין.
whenTextEqualTo(text)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט ששווה לטקסט שצוין.
whenTextEqualToAny(texts)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט ששווה לכל אחד מערכי הטקסט שצוינו.
whenTextNotEqualTo(text)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט שלא שווה לטקסט שצוין.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט שלא שווה לאף אחד מהערכים שצוינו.
whenTextStartsWith(text)FilterCriteriaBuilderהגדרת קריטריוני הסינון להצגת תאים עם טקסט שמתחיל בטקסט שצוין.
withCriteria(criteria, args)FilterCriteriaBuilderמגדיר את הקריטריונים לסינון לתנאי בוליאני שמוגדר על ידי ערכי BooleanCriteria, כמו CELL_EMPTY או NUMBER_GREATER_THAN.

תיעוד מפורט

build()

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

// 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 — ייצוג של קריטריוני הסינון.

copy()

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

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

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 — בונה קריטריוני סינון שמבוסס על קריטריוני הסינון האלה.

getCriteriaType()

הפונקציה מחזירה את הסוג הבוליאני של הקריטריון, לדוגמה, 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 – סוג הקריטריון הבוליאני, או null אם הקריטריון הוא לא תנאי בוליאני.

getCriteriaValues()

מחזירה מערך של ארגומנטים לקריטריונים בוליאניים. לחלק מסוגי הקריטריונים הבוליאניים אין ארגומנטים והם מחזירים מערך ריק, לדוגמה, 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.

getHiddenValues()

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

אפשר להשתמש בקריטריונים האלה עם מסננים בגיליונות 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[] — מערך של ערכים שהמסנן מסתיר.

getVisibleBackgroundColor()

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

אפשר להשתמש בקריטריונים האלה עם מסננים בגיליונות 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|null — צבע הרקע שמשמש כקריטריון לסינון.

getVisibleForegroundColor()

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

אפשר להשתמש בקריטריונים האלה עם מסננים בגיליונות 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|null — צבע החזית שמשמש כקריטריון לסינון.

getVisibleValues()

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

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

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[] – מערך של ערכים שמוצגים במסנן של טבלת הצירים.

setHiddenValues(values)

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

אפשר להשתמש בקריטריון הזה רק במסננים בגיליונות 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);

פרמטרים

שםסוגתיאור
valuesString[]רשימת הערכים להסתרה.

חזרה

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

מקפיצה את הודעות השגיאה (Throws)

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

setVisibleBackgroundColor(visibleBackgroundColor)

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

אפשר להשתמש בקריטריון הזה רק במסננים בגיליונות 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);

פרמטרים

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

חזרה

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

setVisibleForegroundColor(visibleForegroundColor)

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

אפשר להשתמש בקריטריון הזה רק במסננים בגיליונות 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);

פרמטרים

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

חזרה

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

setVisibleValues(values)

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

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

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

פרמטרים

שםסוגתיאור
valuesString[]רשימת הערכים שיוצגו.

חזרה

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

מקפיצה את הודעות השגיאה (Throws)

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

whenCellEmpty()

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

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

// 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 הזה, לשרשור.

whenCellNotEmpty()

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

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

// 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 הזה, לשרשור.

whenDateAfter(date)

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

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

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

פרמטרים

שםסוגתיאור
dateDateהתאריך האחרון להסתרה.

חזרה

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

whenDateAfter(date)

הגדרת קריטריונים של מסנן שמציג תאים עם תאריכים שחלים אחרי התאריך היחסי שצוין. כדי לראות את האפשרויות של תאריכים יחסיים, אפשר לעיין ב-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);

פרמטרים

שםסוגתיאור
dateRelativeDateהתאריך היחסי האחרון.

חזרה

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

whenDateBefore(date)

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

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

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

פרמטרים

שםסוגתיאור
dateDateהתאריך המוקדם ביותר להסתרה.

חזרה

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

whenDateBefore(date)

הגדרת קריטריוני סינון שמציגים תאים עם תאריכים שקודמים לתאריך היחסי שצוין. כדי לראות את האפשרויות של תאריכים יחסיים, אפשר לעיין ב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);

פרמטרים

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

חזרה

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

whenDateEqualTo(date)

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

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

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

פרמטרים

שםסוגתיאור
dateDateהתאריך שערכי התאים צריכים להיות זהים לו.

חזרה

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

whenDateEqualTo(date)

הגדרת קריטריונים לסינון שמציגים תאים עם תאריכים ששווים לתאריך היחסי שצוין. כדי לראות את האפשרויות של תאריכים יחסיים, אפשר לעיין ב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);

פרמטרים

שםסוגתיאור
dateRelativeDateהתאריך היחסי שערכי התאים צריכים להתאים לו.

חזרה

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

whenDateEqualToAny(dates)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
datesDate[]התאריכים שיוצגו.

חזרה

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

whenDateNotEqualTo(date)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
dateDateהתאריך שרוצים להסתיר.

חזרה

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

whenDateNotEqualToAny(dates)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
datesDate[]התאריכים שרוצים להסתיר.

חזרה

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

whenFormulaSatisfied(formula)

מגדיר את קריטריוני הסינון להצגת תאים עם נוסחה שצוינה (למשל =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);

פרמטרים

שםסוגתיאור
formulaStringנוסחה מותאמת אישית שמחזירה את הערך true אם הקלט תקין.

חזרה

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

whenNumberBetween(start, end)

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

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

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

פרמטרים

שםסוגתיאור
startNumberהמספר הנמוך ביותר שיוצג.
endNumberהמספר הכי גבוה שיוצג.

חזרה

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

whenNumberEqualTo(number)

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

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

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

פרמטרים

שםסוגתיאור
numberNumberהמספר שיוצג.

חזרה

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

whenNumberEqualToAny(numbers)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
numbersNumber[]המספרים שיוצגו.

חזרה

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

whenNumberGreaterThan(number)

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

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

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הכי גבוה להסתרה.

חזרה

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

whenNumberGreaterThanOrEqualTo(number)

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

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

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הנמוך ביותר שיוצג.

חזרה

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

whenNumberLessThan(number)

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

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

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הכי נמוך שיוסתר.

חזרה

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

whenNumberLessThanOrEqualTo(number)

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

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

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הכי גבוה שיוצג.

חזרה

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

whenNumberNotBetween(start, end)

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

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

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

פרמטרים

שםסוגתיאור
startNumberהמספר הנמוך ביותר להסתרה.
endNumberהמספר הכי גבוה להסתרה.

חזרה

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

whenNumberNotEqualTo(number)

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

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

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

פרמטרים

שםסוגתיאור
numberNumberהמספר שרוצים להסתיר.

חזרה

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

whenNumberNotEqualToAny(numbers)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
numbersNumber[]המספרים שרוצים להסתיר.

חזרה

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

whenTextContains(text)

הגדרת קריטריוני הסינון להצגת תאים עם טקסט שמכיל את הטקסט שצוין. הטקסט לא תלוי אותיות רישיות (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);

פרמטרים

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

חזרה

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

whenTextDoesNotContain(text)

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

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

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

פרמטרים

שםסוגתיאור
textStringהטקסט שהתא לא יכול להכיל.

חזרה

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

whenTextEndsWith(text)

הגדרת קריטריוני הסינון להצגת תאים עם טקסט שמסתיים בטקסט שצוין. הטקסט לא תלוי אותיות רישיות (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);

פרמטרים

שםסוגתיאור
textStringטקסט שחייב להיות בסוף הטקסט בתא.

חזרה

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

whenTextEqualTo(text)

הגדרת קריטריוני הסינון להצגת תאים עם טקסט ששווה לטקסט שצוין. הטקסט לא תלוי אותיות רישיות (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);

פרמטרים

שםסוגתיאור
textStringהטקסט שחייב להיות שווה לטקסט בתא.

חזרה

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

whenTextEqualToAny(texts)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
textsString[]ערכי הטקסט שהתא צריך להיות שווה להם.

חזרה

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

whenTextNotEqualTo(text)

הגדרת קריטריוני הסינון להצגת תאים עם טקסט שלא שווה לטקסט שצוין. הטקסט לא תלוי באותיות רישיות (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 text equal to
// "tech."
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextNotEqualTo('tech').build();
dataSheet.addFilter('category', criteria);

פרמטרים

שםסוגתיאור
textStringהטקסט שהטקסט בתא לא יכול להיות שווה לו.

חזרה

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

whenTextNotEqualToAny(texts)

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

אפשר להשתמש בקריטריון הזה רק עם נתונים שמקושרים למסד נתונים. לדוגמה, אפשר להשתמש בקריטריונים האלה עם מסננים בגיליון 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);

פרמטרים

שםסוגתיאור
textsString[]ערכי הטקסט שהתא לא יכול להיות שווה להם.

חזרה

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

whenTextStartsWith(text)

הגדרת קריטריוני הסינון להצגת תאים עם טקסט שמתחיל בטקסט שצוין. הטקסט לא תלוי אותיות רישיות (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);

פרמטרים

שםסוגתיאור
textStringטקסט שחייב להיות בתחילת הטקסט בתא.

חזרה

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

withCriteria(criteria, args)

הגדרת הקריטריונים לסינון לתנאי בוליאני שמוגדר על ידי ערכי 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);

פרמטרים

שםסוגתיאור
criteriaBooleanCriteriaסוג הקריטריונים הבוליאניים.
argsObject[]מערך של ארגומנטים שמתאימים לסוג הקריטריונים. מספר הארגומנטים והסוג שלהם תואמים לשיטות when...() שמופיעות למעלה.

חזרה

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