Partager via


RANGE

Applies to:Calculated columnCalculated tableMeasureVisual calculation

Retourne un intervalle de lignes dans l’axe donné, par rapport à la ligne actuelle. Cet intervalle se compose des dernières lignes step avant l’une ou la première step lignes après celle-ci.

Syntax

RANGE ( <step>[, <includeCurrent>][, <axis>][, <orderBy>][, <blanks>][, <reset>] )

Parameters

Term Definition
step Nombre de lignes avant (valeur négative) ou après (valeur positive) de la ligne actuelle à inclure dans la plage. Doit être une valeur constante.
: si elle est négative, la fenêtre contient les dernières lignes -step avant la ligne active.
- Sinon, la fenêtre contient les premières lignes d’étape après la ligne active.
includeCurrent (Facultatif) Valeur logique spécifiant s’il faut inclure ou non la ligne actuelle dans la plage. La valeur par défaut est True.
axis (Facultatif) Référence d’axe, direction le long de laquelle l’intervalle sera créé. S’il est omis, le premier axe de la définition de forme visuelle est utilisé.
orderBy (Facultatif) Clause ORDERBY() avec des expressions qui déterminent comment trier chaque partition le long du axis. Si orderBy ce n’est pas le cas, les données sont triées par les colonnes de regroupement par défaut axis dans l’ordre croissant par défaut.
blanks (Facultatif) Énumération qui définit comment gérer les valeurs vides lors du tri du axis.
Les valeurs prises en charge sont les suivantes :
  • DEFAULT (valeur par défaut), où le comportement des valeurs numériques est des valeurs vides sont classés entre zéro et valeurs négatives. Le comportement des chaînes est des valeurs vides classées avant toutes les chaînes, y compris les chaînes vides.
  • FIRST, les espaces sont toujours classés au début, quel que soit l’ordre croissant ou décroissant.
  • LAST, les espaces sont toujours triés à la fin, quel que soit l’ordre croissant ou décroissant.
reset (Facultatif) Indique si le calcul est réinitialisé et au niveau de la hiérarchie des colonnes de la forme visuelle. Les valeurs acceptées sont : une référence de champ à une colonne dans la forme visuelle actuelle, NONE (valeur par défaut), LOWESTPARENT, HIGHESTPARENTou un entier. Le comportement dépend du signe entier :
- Si zéro ou omis, le calcul ne se réinitialise pas. Équivalent à NONE.
- Si positif, l’entier identifie la colonne à partir du plus haut, indépendamment du grain. HIGHESTPARENT équivaut à 1.
- Si négatif, l’entier identifie la colonne à partir de la plus basse, par rapport au grain actuel. LOWESTPARENT équivaut à -1.

Return value

Intervalle de lignes de données.

Remarks

Cette fonction peut être utilisée uniquement dans les calculs visuels.

Les includeCurrentparamètres , et axisles resetorderByblanks paramètres peuvent être omis.

Si la valeur est reset absolue (c’est-à-dire un entier HIGHESTPARENT positif ou une référence de champ) et que le calcul est évalué au niveau cible ou supérieur à celui de la hiérarchie, le calcul est réinitialisé pour chaque élément individuel. Autrement dit, la fonction est évaluée dans une partition contenant uniquement cet élément spécifique.

Example 1

Compte tenu d’un tableau qui récapitule le total des ventes pour chaque catégorie de produit et chaque mois, la requête DAX suivante ajoute une colonne avec le total des ventes au cours des 6 derniers mois :

TotalSalesLast6Months = CALCULATE(SUM([SalesAmount]), RANGE(-5, Rows))

La capture d’écran ci-dessous montre la matrice visuelle et l’expression de calcul visuel :

DAX calcul visuel

Example 2

Étant donné le même tableau, la requête DAX suivante ajoute une colonne avec le total des ventes au cours des 12 mois suivants, sans inclure le mois en cours :

TotalSalesFollowingYear = CALCULATE(SUM([SalesAmount]), RANGE(12, FALSE, Rows, KEEP))

See also

INDEX ORDERBY PARTITIONBY WINDOW