Documentation/Calc Functions/AGGREGATE/fr

Nom de la fonction :
AGREGAT

Catégorie :
Mathématique

Résumé :
AGREGAT est une fonction puissante mais complexe qui calcule un nombre unique en appliquant une fonction d'agrégation sélectionnée à un ensemble de données spécifié. Dix-neuf fonctions d'agrégation différentes sont disponibles.

Contrairement à de nombreuses autres fonctions qui effectuent des calculs similaires, AGREGAT fournit des options pour omettre certains types de données indésirables dans son traitement. Des options sont disponibles pour ignorer les erreurs, les lignes masquées, les SOUS-TOTAUX imbriqués et les autres résultats de la fonction AGREGAT.

Syntaxe :
AGREGAT(Fonction; Option; Nombre1[; Nombre2[; ... [; Nombre253]]])

ou

AGREGAT(Fonction; Option; Matrice; k)

La première syntaxe est destinée à être utilisée avec les valeurs de Fonction de 1 à 13, tandis que la deuxième syntaxe est destinée à être utilisée avec les valeurs de Fonction de 14 à 19.

Renvoie :
Renvoie une valeur numérique qui est le résultat de l'application de la fonction d'agrégation sélectionnée et ignore les options à l'ensemble de données spécifié.

Arguments :
Fonction est une valeur entière dans la plage [1, 19], ou une référence à une cellule contenant ce nombre, qui spécifie la fonction d'agrégation à utiliser. Le tableau suivant montre le mappage de ces valeurs aux fonctions d'agrégation.

Option est une valeur entière dans la plage [0, 7], ou une référence à une cellule contenant ce nombre, qui spécifie l'option ignorée à utiliser. Le tableau suivant montre quels types de données sont ignorés pour chaque valeur.

Nombre1, Nombre2, ..., Nombre253 sont les arguments numériques devant être calculés lorsque Fonction est dans la plage [1, 13]. Ceux-ci sont similaires à ceux des fonctions seules utilisées pour l'agrégation, voir par exemple MOYENNE, NB, and MAX. Chaque argument peut prendre l'une des formes suivantes :


 * Un nombre ou une expression dont la valeur est un nombre.
 * Une référence à une seule cellule contenant un nombre.
 * Une simple référence à une plage de cellules contenant des nombres (par exemple, A1:B9).
 * Le nom d'une plage nommée, comprenant des cellules contenant des nombres.
 * Le nom d'une plage de base de données, comprenant des cellules contenant des nombres.
 * Une matrice de nombres en ligne (par exemple, {1, 2, 3, 4}).
 * Le texte de l'étiquette d'en-tête au-dessus d'une colonne de nombres, entouré de guillemets simples - uniquement disponible si l'option Outils > Options > LibreOffice Calc > Calculer > Rechercher automatiquement les étiquettes de colonne et de ligne est activée ( 'LibreOffice > Préférences > LibreOffice Calc > Calculer > Rechercher automatiquement les étiquettes de colonne et de ligne' sur macOS).

Array contains the numeric arguments to be processed when Function is in the range [14, 19]. This argument is similar to the Data argument of the standalone functions used for aggregation, see LARGE, PERCENTILE.EXC, PERCENTILE.INC, QUARTILE.INC, QUARTILE.EXC, and SMALL. The Array argument may take one of the forms listed above for Number1, Number2, ..., Number253.

k is required when Function is in the range [14, 19] and specifies the second argument required by the standalone aggregation function. These are as follows:


 * LARGE requires a RankC argument (positive integer).
 * SMALL requires a RankC argument (positive integer).
 * PERCENTILE.INC requires an Alpha argument (real number in the range [0, 1]).
 * PERCENTILE.EXC requires an Alpha argument (real number in the range (0, 1)).
 * QUARTILE.INC requires a Type argument (integer in the range [0, 4]).
 * QUARTILE.EXC requires a Type argument (integer in the range [1, 3]).

The following error conditions may be encountered:


 * If either Function or Option is non-numeric, then AGGREGATE reports an invalid argument error (Err:502).
 * If either Function or Option is not an integer, the value is truncated to its floor value.
 * If Function is less than 1 or greater than 19, then AGGREGATE reports an invalid argument error (Err:502).
 * If Option is less than 0 or greater than 7, then AGGREGATE reports an invalid argument error (Err:502).
 * Other errors may be generated depending on the aggregate function selected and the data supplied. For example, a #DIV/0! error is generated if Function is set to 7 (STDEV.S) and only one data value is supplied. Another example occurs when a #VALUE! error is generated if Function is set to 13 (MODE.SNGL) and the supplied data contains no duplicate data points. More information about such error conditions can be found on the wiki pages for the standalone versions of the aggregate functions.

Additional details:
The AGGREGATE function is best used for columns of data, rather than rows of data, because hiding columns does not have any effect on the results of AGGREGATE.

Examples:
The following table shows sample data that is used in the subsequent examples of the AGGREGATE function.

Related LibreOffice functions:
AVERAGE

COUNT

COUNTA

LARGE

MAX

MEDIAN

MIN

MODE.SNGL

PERCENTILE.EXC

PERCENTILE.INC

PRODUCT

QUARTILE.EXC

QUARTILE.INC

SMALL

STDEV.P

STDEV.S

SUM

VAR.P

VAR.S

ODF standard:
None

Equivalent Excel functions:
AGGREGATE