Partager via

PARALLELPERIOD

  • Article

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Note

Cette fonction est déconseillée pour une utilisation dans calculs visuels car elle retourne probablement des résultats sans signification.

Retourne une table qui contient une colonne de dates qui représente 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 temps ou en arrière 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 ou soustraire des dates.
interval Intervalle par lequel déplacer les dates. La valeur de l’intervalle peut être l’une des suivantes : year, quarter, month.

Valeur de retour

Table contenant une seule colonne de valeurs de date.

Remarques

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

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

    • Référence à une colonne de date/heure,
    • Expression de table qui retourne une seule colonne de valeurs de date/heure,
    • Expression booléenne qui définit une table à colonne unique de valeurs de date/heure.

  • 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 dates sont déplacées vers l’avant dans le temps ; si le nombre est négatif, les dates dans dates sont décalées dans le temps.

  • Le paramètre interval est une énumération, et non un ensemble de chaînes ; par conséquent, les valeurs ne doivent pas être placées entre guillemets. En outre, les valeurs : year, quarter, month doivent être orthographiés en totalité lors de leur utilisation.

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

  • La fonction PARALLELPERIOD est similaire à la fonction DATEADD, sauf que PARALLELPERIOD retourne toujours des périodes complètes au niveau de granularité donné au lieu des périodes partielles qui DATEADD retourne. Par exemple, si vous avez une sélection de dates qui commencent au 10 juin et se termine le 21 juin de la même année, et que vous souhaitez transférer cette sélection d’un mois, la fonction PARALLELPERIOD retourne toutes les dates du mois suivant (1er juillet au 31 juillet). toutefois, si DATEADD est utilisé à 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 lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).

Exemple

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

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

Contenu connexe

fonctions Time Intelligencefonctions Date et heureDATEADD fonction