RANGE

S’applique à :Colonne calculéeTable calculéeMesureCalcul visuel

Retourne un intervalle de lignes dans l’axe donné, par rapport à la ligne actuelle. Cet intervalle sera constitué des dernières lignes de l’<étape> avant l’étape actuelle, ou des premières lignes de l’<étape> après l’étape actuelle.

Syntaxe

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

Paramètres

Terme	Définition
step	Le nombre de lignes avant (valeur négative) ou après (valeur positive) la ligne actuelle à inclure dans la plage. Doit être une valeur constante. : Si elle est négative, la fenêtre contiendra les dernières lignes de l’étape avant la ligne actuelle. : sinon, la fenêtre contiendra les premières lignes de l’étape après la ligne actuelle.
includeCurrent	(Facultatif) Une valeur logique spécifiant s’il faut ou non inclure la ligne active dans la plage. La valeur par défaut est True.
axis	(Facultatif) Une référence d’axe, la direction le long de laquelle l’intervalle sera créé.
vides	(Facultatif) Énumération qui définit comment gérer des valeurs vides lors du tri. Les valeurs prises en charge sont : DEFAULT (la valeur par défaut), où le comportement pour les valeurs numériques est que les valeurs vides sont classées entre les valeurs zéro et les valeurs négatives. Le comportement des chaînes est que les valeurs vides sont triées avant toutes les chaînes, y compris les chaînes vides. FIRST, les valeurs vides sont toujours classées au début, que l’ordre de tri soit croissant ou décroissant. LAST, les valeurs vides sont toujours classées à la fin, que l’ordre de tri soit croissant ou décroissant.
reset	(Facultatif) Indique si le calcul est réinitialisé et à quel niveau de la hiérarchie des colonnes de la forme visuelle. Les valeurs acceptées sont : NONE, LOWESTPARENT, HIGHESTPARENT ou un entier. Le comportement dépend du signe de l’entier : - S’il est égal à zéro ou s’il est omis, le calcul n’est pas réinitialisé. Équivalent à NONE. - S’il est positif, l’entier identifie la colonne en commençant par la plus élevée, indépendamment du fragment. HIGHESTPARENT équivaut à 1. - S’il est négatif, l’entier identifie la colonne en commençant par la plus basse, par rapport au fragment actuel. LOWESTPARENT équivaut à -1.

Valeur retournée

Un intervalle de lignes de données.

Notes

Cette fonction peut être utilisée seulement dans les calculs de visuel.

Les paramètres <includeCurrent>, <axis>, <blanks> et <reset> peuvent être omis.

Exemple 1

Dans une table récapitulant les ventes totales pour chaque catégorie de produit et chaque mois, la requête DAX suivante ajoute une colonne contenant les ventes totales au cours des 6 derniers mois :

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

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

Exemple 2

Dans la même table, la requête DAX suivante ajoute une colonne avec le total des ventes dans les 12 mois suivants, sans y inclure le mois actuel :

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

Voir aussi

INDEX
ORDERBY
PARTITIONBY
WINDOW