PARALLELPERIOD

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.

Pour l’entrée de colonne de date, retourne une table qui contient une colonne de dates qui représente une période parallèle aux dates de la colonne spécifiée dates , dans le contexte actuel, avec les dates décalées un certain nombre d’intervalles vers l’avant ou dans le temps.

Pour l’entrée de calendrier, retourne une table qui représente une période parallèle aux dates dans le contexte actuel, en fonction du calendrier, avec le décalage de dates un certain nombre d’intervalles en temps ou en arrière dans le temps. La table contient toutes les colonnes marquées principales et toutes les colonnes associées à l’heure.

Syntaxe

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

Paramètres

Terme	Définition
dates or calendar	Colonne qui contient des dates ou une référence de calendrier
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, , quartermonth, week. La valeur de semaine s’applique uniquement lorsque la syntaxe du calendrier est utilisée.

Valeur de retour

Pour l’entrée de colonne de date, une table contenant une seule colonne de valeurs de date.
Pour l’entrée de calendrier, une table qui contient toutes les colonnes marquées principales et toutes les colonnes associées à l’heure.

Remarques

• Pour l’entrée de colonne de date, 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 )
)

Exemple pour l’intelligence temporelle basée sur le calendrier

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

= CALCULATE (
    SUM ( InternetSales_USD[SalesAmount_USD] ),
    PARALLELPERIOD ( FiscalCalendar, -1, YEAR )
)

Contenu connexe

fonctions Time Intelligencefonctions Date et heureDATEADD fonction