Pour ajouter des critères à un filtre, procédez comme suit:
- Créez le générateur de critères à l'aide de
SpreadsheetApp.newFilterCriteria()
. - Ajoutez des paramètres au compilateur à l'aide des méthodes de cette classe.
- Utilisez
build()
pour assembler les critères en fonction des paramètres que vous avez spécifiés.
Utilisations courantes
Masquer les valeurs d'une feuille
L'exemple suivant récupère une feuille existante et ajoute un critère qui masque les cellules de la colonne C contenant "hello" ou "world". Les critères de cet exemple ne peuvent être utilisés qu'avec des filtres sur les feuillesGrid
, le type de feuille par défaut.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["hello", "world"]) .build(); filter.setColumnFilterCriteria(3, criteria);
Afficher uniquement les cellules non vides
L'exemple suivant ajoute un filtre à une feuilleDataSource
, c'est-à-dire une feuille connectée à une base de données, avec des critères qui n'affichent que les cellules de la colonne"Category"qui ne sont pas vides.
// 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);
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
build() | FilterCriteria | Assemble les critères de filtre à l'aide des paramètres que vous ajoutez à l'outil de création de critères. |
copy() | FilterCriteriaBuilder | Il copie ce critère de filtre et crée un outil de création de critères que vous pouvez appliquer à un autre filtre. |
getCriteriaType() | BooleanCriteria | Renvoie le type booléen critère, par exemple, CELL_EMPTY . |
getCriteriaValues() | Object[] | Renvoie un tableau d'arguments pour les critères booléens. |
getHiddenValues() | String[] | Renvoie les valeurs masquées par le filtre. |
getVisibleBackgroundColor() | Color | Renvoie la couleur d'arrière-plan utilisée comme critère de filtre. |
getVisibleForegroundColor() | Color | Renvoie la couleur de premier plan utilisée comme critère de filtre. |
getVisibleValues() | String[] | Renvoie les valeurs affichées par le filtre du tableau croisé dynamique. |
setHiddenValues(values) | FilterCriteriaBuilder | Définit les valeurs à masquer. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Définit la couleur d'arrière-plan utilisée comme critère de filtre. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Définit la couleur de premier plan utilisée comme critère de filtre. |
setVisibleValues(values) | FilterCriteriaBuilder | Définit les valeurs à afficher dans un tableau croisé dynamique. |
whenCellEmpty() | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules vides. |
whenCellNotEmpty() | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules qui ne sont pas vides. |
whenDateAfter(date) | FilterCriteriaBuilder | Définit les critères de filtre qui affichent les cellules dont la date est postérieure à la date spécifiée. |
whenDateAfter(date) | FilterCriteriaBuilder | Définit les critères de filtre qui affichent les cellules dont les dates sont postérieures à la date relative spécifiée. |
whenDateBefore(date) | FilterCriteriaBuilder | Définit les critères de filtre qui affichent les cellules dont les dates sont antérieures à la date spécifiée. |
whenDateBefore(date) | FilterCriteriaBuilder | Définit les critères de filtre qui affichent les cellules dont les dates sont antérieures à la date relative spécifiée. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Définit les critères de filtre qui affichent les cellules dont les dates sont égales à la date spécifiée. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Définit un critère de filtre qui affiche les cellules dont les dates sont égales à la date relative spécifiée. |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont les dates sont égales à l'une des dates spécifiées. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules qui ne sont pas égales à la date spécifiée. |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont les dates ne sont pas égales à l'une des dates spécifiées. |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Définit les critères de filtre de manière à afficher les cellules avec une formule spécifiée (telle que =B:B<C:C ) qui renvoie true . |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Définit le critère de filtre de manière à afficher les cellules dont le nombre est compris entre deux chiffres spécifiés. |
whenNumberEqualTo(number) | FilterCriteriaBuilder | Définit les critères de filtre de manière à afficher les cellules dont le nombre est égal au nombre indiqué. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le nombre est égal à l'un des nombres spécifiés. |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | Définit le critère de filtre de manière à afficher les cellules dont le nombre est supérieur au nombre indiqué |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | Définit le critère de filtre de manière à afficher les cellules dont le nombre est supérieur ou égal au nombre spécifié. |
whenNumberLessThan(number) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le nombre est inférieur au nombre indiqué. |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le nombre est inférieur ou égal au nombre spécifié. |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | Définit le critère de filtre de manière à afficher les cellules dont le nombre n'est pas compris entre deux nombres spécifiés. |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le nombre n'est pas égal au nombre indiqué. |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le numéro n'est pas égal à l'un des nombres spécifiés. |
whenTextContains(text) | FilterCriteriaBuilder | Définit les critères de filtre de manière à afficher les cellules dont le texte contient le texte spécifié. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | Définit le critère de filtre de manière à afficher les cellules dont le texte ne contient pas le texte spécifié. |
whenTextEndsWith(text) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le texte se termine par le texte spécifié. |
whenTextEqualTo(text) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le texte correspond au texte spécifié. |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le texte correspond à l'une des valeurs textuelles spécifiées. |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le texte n'est pas égal au texte spécifié. |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le texte n'est pas égal à l'une des valeurs spécifiées. |
whenTextStartsWith(text) | FilterCriteriaBuilder | Définit les critères de filtre pour afficher les cellules dont le texte commence par le texte spécifié. |
withCriteria(criteria, args) | FilterCriteriaBuilder | Définit les critères de filtre sur une condition booléenne définie par des valeurs BooleanCriteria , telles que CELL_EMPTY ou NUMBER_GREATER_THAN . |
Documentation détaillée
build()
Assemble les critères de filtre à l'aide des paramètres que vous ajoutez à l'outil de création de critères.
// 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);
Aller-retour
FilterCriteria
: représentation des critères de filtre.
copy()
Il copie ce critère de filtre et crée un outil de création de critères que vous pouvez appliquer à un autre filtre.
Vous pouvez utiliser cette méthode avec n'importe quel type de filtre. Si vous utilisez un filtre de feuille, vous pouvez copier les critères dans une autre colonne.
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);
Aller-retour
FilterCriteriaBuilder
: outil de création de critères de filtre basé sur ces critères de filtre.
getCriteriaType()
Renvoie le type booléen critère, par exemple, CELL_EMPTY
. Pour en savoir plus sur les types de critères booléens, consultez l'énumération BooleanCriteria
.
Les gens utilisent souvent cette méthode pour ajouter des critères de condition booléens à un filtre sans remplacer les critères existants.
- Pour obtenir les arguments des critères, utilisez
getCriteriaValues()
. - Pour utiliser le type et les valeurs de critère afin de créer ou de modifier des critères de filtrage, consultez la page
withCriteria(criteria, args)
.
Vous pouvez utiliser cette méthode pour tout type de filtre. Si le critère de filtre n'est pas une condition booléenne, renvoie 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);
Aller-retour
BooleanCriteria
: type de critère booléen, ou null
si le critère n'est pas une condition booléenne.
getCriteriaValues()
Renvoie un tableau d'arguments pour les critères booléens. Certains types de critères booléens n'ont pas d'arguments et renvoient un tableau vide, par exemple CELL_NOT_EMPTY
.
Les gens utilisent souvent cette méthode pour ajouter des critères de condition booléens à un filtre sans remplacer les critères existants.
- Pour obtenir le type de critère booléen, utilisez
getCriteriaType()
. - Pour utiliser le type et les valeurs de critère afin de créer ou de modifier un critère de filtre, consultez la section
withCriteria(criteria, args)
.Vous pouvez utiliser cette méthode pour tout type de filtre.
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);
Aller-retour
Object[]
: tableau d'arguments adaptés au type de critère booléen. Le nombre d'arguments et leur type correspondent à la méthodewhen...()
correspondante de la classeFilterCriteriaBuilder
.
getHiddenValues()
Renvoie les valeurs masquées par le filtre.
Utilisez ce critère avec des filtres sur Grid
feuilles, le type de feuille par défaut.
Renvoie null
si vous appelez cette méthode pour d'autres types de filtres.
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);
Aller-retour
String[]
: tableau de valeurs masquées par le filtre.
getVisibleBackgroundColor()
Renvoie la couleur d'arrière-plan utilisée comme critère de filtre. Les cellules de cette couleur restent visibles.
Utilisez ce critère avec des filtres sur Grid
feuilles, le type de feuille par défaut.
Renvoie null
si vous appelez cette méthode pour d'autres types de filtres.
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);
Aller-retour
Color
: couleur d'arrière-plan utilisée comme critère de filtre.
getVisibleForegroundColor()
Renvoie la couleur de premier plan utilisée comme critère de filtre. Les cellules de cette couleur de premier plan restent visibles.
Utilisez ce critère avec des filtres sur Grid
feuilles, le type de feuille par défaut.
Renvoie null
si vous appelez cette méthode pour d'autres types de filtres.
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);
Aller-retour
Color
: couleur de premier plan utilisée comme critère de filtre.
getVisibleValues()
Renvoie les valeurs affichées par le filtre du tableau croisé dynamique.
Ce critère ne concerne que les filtres des tableaux croisés dynamiques qui ne sont pas connectés à une base de données. Renvoie un tableau vide pour les autres types de filtres.
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);
Aller-retour
String[]
: tableau de valeurs affichées par le filtre du tableau croisé dynamique.
setHiddenValues(values)
Définit les valeurs à masquer. Efface toutes les valeurs visibles ou masquées existantes.
Vous ne pouvez utiliser ce critère que pour les filtres sur Grid
feuilles, le type de feuille par défaut.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
values | String[] | Liste des valeurs à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
setVisibleBackgroundColor(visibleBackgroundColor)
Définit la couleur d'arrière-plan utilisée comme critère de filtre. Les cellules de cette couleur restent visibles. Définir un critère de filtre de couleur d'arrière-plan supprime tous les critères de filtre de couleur actuels de cet outil de création.
Vous ne pouvez utiliser ce critère que pour les filtres sur Grid
feuilles, le type de feuille par défaut.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
visibleBackgroundColor | Color | Couleur d'arrière-plan à définir. La couleur doit être de style RVB. Cette méthode ne prend pas en charge les couleurs de thème. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
setVisibleForegroundColor(visibleForegroundColor)
Définit la couleur de premier plan utilisée comme critère de filtre. Les cellules de cette couleur de premier plan restent visibles. Définir un critère de filtre de couleur de premier plan supprime tous les critères de filtre de couleur actuels de cet outil de création.
Vous ne pouvez utiliser ce critère que pour les filtres sur Grid
feuilles, le type de feuille par défaut.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
visibleForegroundColor | Color | Couleur de premier plan à définir. La couleur doit être de style RVB. Cette méthode ne prend pas en charge les couleurs de thème. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
setVisibleValues(values)
Définit les valeurs à afficher dans un tableau croisé dynamique. Efface toutes les valeurs visibles ou masquées existantes.
Vous ne pouvez utiliser ce critère que pour les filtres de tableaux croisés dynamiques qui ne sont pas connectés à une base de données.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
values | String[] | Liste des valeurs à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenCellEmpty()
Définit les critères de filtre pour afficher les cellules vides.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenCellNotEmpty()
Définit les critères de filtre pour afficher les cellules qui ne sont pas vides.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateAfter(date)
Définit les critères de filtre qui affichent les cellules dont la date est postérieure à la date spécifiée.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être une date. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être une date. Si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Dernière date à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateAfter(date)
Définit les critères de filtre qui affichent les cellules dont les dates sont postérieures à la date relative spécifiée. Pour afficher les options de date relatives, reportez-vous à la section énumération RelativeDate
.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être une date. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être une date. Si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | RelativeDate | Dernière date relative. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateBefore(date)
Définit les critères de filtre qui affichent les cellules dont les dates sont antérieures à la date spécifiée.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être une date. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être une date. Si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Première date à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateBefore(date)
Définit les critères de filtre qui affichent les cellules dont les dates sont antérieures à la date relative spécifiée.
Pour afficher les options de date relatives, reportez-vous à la section Énumération RelativeDate
.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être une date. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être une date. Si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | RelativeDate | Première date relative à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateEqualTo(date)
Définit les critères de filtre qui affichent les cellules dont les dates sont égales à la date spécifiée.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être une date. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être une date. Si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Date à laquelle les valeurs de la cellule doivent correspondre. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateEqualTo(date)
Définit un critère de filtre qui affiche les cellules dont les dates sont égales à la date relative spécifiée.
Pour afficher les options de date relatives, reportez-vous à la section Énumération RelativeDate
.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être une date. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être une date. Si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | RelativeDate | Date relative à laquelle les valeurs de la cellule doivent correspondre. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateEqualToAny(dates)
Définit les critères de filtre pour afficher les cellules dont les dates sont égales à l'une des dates spécifiées.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
dates | Date[] | Dates à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateNotEqualTo(date)
Définit les critères de filtre pour afficher les cellules qui ne sont pas égales à la date spécifiée.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille DataSource
.
Le type de données de la colonne utilisée pour le filtrage doit être une date.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Date à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenDateNotEqualToAny(dates)
Définit les critères de filtre pour afficher les cellules dont les dates ne sont pas égales à l'une des dates spécifiées.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
dates | Date[] | Dates à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenFormulaSatisfied(formula)
Définit les critères de filtre de manière à afficher les cellules avec une formule spécifiée (telle que =B:B<C:C
) qui renvoie true
.
Vous ne pouvez utiliser ce critère que pour filtrer les données qui ne sont pas connectées à une base de données.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
formula | String | Formule personnalisée qui renvoie true si l'entrée est valide. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberBetween(start, end)
Définit le critère de filtre de manière à afficher les cellules dont le nombre est compris entre deux chiffres spécifiés.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
start | Number | Nombre le plus faible à afficher. |
end | Number | Nombre le plus élevé à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberEqualTo(number)
Définit les critères de filtre de manière à afficher les cellules dont le nombre est égal au nombre indiqué.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Nombre à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberEqualToAny(numbers)
Définit les critères de filtre pour afficher les cellules dont le nombre est égal à l'un des nombres spécifiés.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
numbers | Number[] | Nombres à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberGreaterThan(number)
Définit le critère de filtre de manière à afficher les cellules dont le nombre est supérieur au nombre indiqué
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Nombre le plus élevé à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberGreaterThanOrEqualTo(number)
Définit le critère de filtre de manière à afficher les cellules dont le nombre est supérieur ou égal au nombre spécifié.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Nombre le plus faible à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberLessThan(number)
Définit les critères de filtre pour afficher les cellules dont le nombre est inférieur au nombre indiqué.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Nombre le plus bas à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberLessThanOrEqualTo(number)
Définit les critères de filtre pour afficher les cellules dont le nombre est inférieur ou égal au nombre spécifié.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Nombre le plus élevé à afficher. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberNotBetween(start, end)
Définit le critère de filtre de manière à afficher les cellules dont le nombre n'est pas compris entre deux nombres spécifiés.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
start | Number | Le nombre le plus bas est masqué. |
end | Number | Nombre le plus élevé à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberNotEqualTo(number)
Définit les critères de filtre pour afficher les cellules dont le nombre n'est pas égal au nombre indiqué.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre. Si vous utilisez ce critère avec des données connectées à une base de données, le type de données de la colonne que vous filtrez doit être un nombre. Si les données ne sont pas connectées à une base de données, le type de données de la colonne que vous filtrez n'a pas besoin d'être un nombre. Toutefois, si ce n'est pas le cas, vous pouvez obtenir des résultats inattendus.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Numéro à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenNumberNotEqualToAny(numbers)
Définit les critères de filtre pour afficher les cellules dont le numéro n'est pas égal à l'un des nombres spécifiés.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
numbers | Number[] | Nombres à masquer. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextContains(text)
Définit les critères de filtre de manière à afficher les cellules dont le texte contient le texte spécifié. Le texte n'est pas sensible à la casse.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte que la cellule doit contenir. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextDoesNotContain(text)
Définit le critère de filtre de manière à afficher les cellules dont le texte ne contient pas le texte spécifié. Le texte n'est pas sensible à la casse.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte que la cellule ne doit pas contenir. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextEndsWith(text)
Définit les critères de filtre pour afficher les cellules dont le texte se termine par le texte spécifié. Le texte n'est pas sensible à la casse.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte que la fin du texte de la cellule doit contenir. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextEqualTo(text)
Définit les critères de filtre pour afficher les cellules dont le texte correspond au texte spécifié. Le texte n'est pas sensible à la casse.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte auquel le texte de la cellule doit être identique. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextEqualToAny(texts)
Définit les critères de filtre pour afficher les cellules dont le texte correspond à l'une des valeurs textuelles spécifiées. Le texte n'est pas sensible à la casse.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
texts | String[] | Valeurs textuelles qu'une cellule doit être égale. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextNotEqualTo(text)
Définit les critères de filtre pour afficher les cellules dont le texte n'est pas égal au texte spécifié. Le texte n'est pas sensible à la casse.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte dont le texte ne peut pas être égal à celui de la cellule. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextNotEqualToAny(texts)
Définit les critères de filtre pour afficher les cellules dont le texte n'est pas égal à l'une des valeurs spécifiées. Le texte n'est pas sensible à la casse.
Vous ne pouvez utiliser ce critère qu'avec des données connectées à une base de données. Par exemple, utilisez ce critère avec des filtres sur une feuille DataSource
, une feuille connectée à une base de données ou un DataSourcePivotTable
, un tableau croisé dynamique créé à partir d'une feuille 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);
Paramètres
Nom | Type | Description |
---|---|---|
texts | String[] | Valeurs textuelles qu'une cellule ne peut pas égaler. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
whenTextStartsWith(text)
Définit les critères de filtre pour afficher les cellules dont le texte commence par le texte spécifié. Le texte n'est pas sensible à la casse.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte au début du texte de la cellule. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage
withCriteria(criteria, args)
Définit les critères de filtre sur une condition booléenne définie par des valeurs BooleanCriteria
, telles que CELL_EMPTY
ou NUMBER_GREATER_THAN
. Pour copier la condition booléenne à partir de critères existants, définissez les paramètres de cette méthode à l'aide de getCriteriaType()
et getCriteriaValues()
sur un critère existant.
Vous pouvez utiliser ce critère avec n'importe quel type de filtre, mais certains BooleanCriteria
ne sont pas applicables à tous les filtres.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
criteria | BooleanCriteria | Type de critère booléen. |
args | Object[] | Tableau d'arguments adaptés au type de critère. Le nombre d'arguments et leur type correspondent aux méthodes when...() correspondantes ci-dessus. |
Aller-retour
FilterCriteriaBuilder
: cet outil de création, pour le chaînage