PARALLELPERIOD

  • Article

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

Remarque

L’utilisation de cette fonction est déconseillée dans les calculs visuels, car elle retournera probablement des résultats non pertinents.

Retourne une table qui contient une colonne de dates représentant une période parallèle aux dates de la colonne dates spécifiée, dans le contexte actuel, avec les dates décalées d’un certain nombre d’intervalles en avançant ou en remontant dans le temps.

Syntaxe

PARALLELPERIOD(<dates>,<number_of_intervals>,<interval>)

Paramètres

Terme Définition
dates Colonne qui contient des dates.
number_of_intervals Entier qui spécifie le nombre d’intervalles à ajouter aux dates ou à soustraire des dates.
interval Intervalle selon lequel les dates doivent être avancées ou reculées. Cet intervalle peut avoir l’une des valeurs suivantes : year, quarter, month.

Valeur de retour

Table contenant une seule colonne de valeurs de date.

Remarques

  • Cette fonction prend l’ensemble de dates actuel dans la colonne spécifiée par dates, décale la première date et la dernière date du nombre d’intervalles spécifié, puis retourne toutes les dates contiguës figurant entre les deux dates décalées. Si l’intervalle est une plage partielle du mois, du trimestre ou de l’année, tous les mois partiels dans le résultat sont également remplis pour compléter l’intervalle entier.

  • L’argument dates peut être l’un des éléments suivants :

    • Une référence à une colonne de date/heure
    • Une expression de table qui retourne une seule colonne de valeurs de date/heure
    • Une expression booléenne qui définit une table de valeurs de date/heure à une seule colonne

  • Les contraintes sur les expressions booléennes sont décrites dans la rubrique CALCULATE, fonction.

  • Si le nombre spécifié pour number_of_intervals est positif, les dates dans la colonne dates sont avancées dans le temps ; s’il est négatif, les dates dans la colonne dates sont reculées dans le temps.

  • Le paramètre interval est une énumération, pas un ensemble de chaînes ; les valeurs ne doivent donc pas être placées entre guillemets. En outre, les valeurs year, quarter et month doivent être épelées intégralement lorsque vous les utilisez.

  • La table de résultats comprend uniquement les dates qui figurent dans les valeurs de la colonne de table sous-jacente.

  • La fonction PARALLELPERIOD est similaire à la fonction DATEADD, si ce n’est que PARALLELPERIOD retourne toujours des périodes entières au niveau de granularité donné, alors que des périodes partielles sont retournées par DATEADD. Par exemple, si vous avez sélectionné des dates qui commencent au 10 juin et se terminent le 21 juin de la même année, et que vous souhaitez décaler cette sélection d’un mois vers l’avant, la fonction PARALLELPERIOD retourne toutes les dates du mois suivant (du 1er juillet au 31 juillet). Toutefois, si la fonction DATEADD est utilisée à la place, le résultat inclut uniquement les dates du 10 juillet au 21 juillet.

  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).

Exemple

L’exemple de formule suivant crée une mesure qui calcule les ventes Internet de l’année précédente.

= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PARALLELPERIOD(DateTime[DateKey],-1,year))

Contenu connexe

Fonctions d’intelligence temporelle
Fonctions de date et heure
DATEADD, fonction