DATESINPERIOD

Si applica a:Calcolo visivo misuratabella calcolata colonnacalcolata

Nota

Questa funzione è sconsigliata per l'uso nei calcoli visivi perché probabilmente restituisce risultati senza significato.

Restituisce una tabella che contiene una colonna di date che inizia con una data di inizio specificata e continua in base al numero e al tipo di intervalli di data specificati.

Questa funzione è adatta per il passaggio come filtro alla funzione CALCULATE. Usarla per filtrare un'espressione in base a intervalli di date standard, ad esempio giorni, mesi, trimestri o anni.

Sintassi

DATESINPERIOD(<dates>, <start_date>, <number_of_intervals>, <interval>)

Parametri

Termine	Definizione
date	Colonna di data.
start_date	Espressione data.
number_of_intervals	Numero intero che specifica il numero di intervalli da aggiungere o sottrarre nelle date.
interval	Intervallo in base al quale spostare le date. I possibili valori per l'intervallo sono i seguenti: DAY, MONTH, QUARTER e YEAR

Valore restituito

Tabella contenente una singola colonna di valori di data.

Osservazioni:

• Nel caso d'uso più comune, dates è un riferimento alla colonna di data di una tabella di date contrassegnata.

• Se il numero specificato per number_of_intervals è positivo, le date vengono spostate avanti nel tempo. Se il numero è negativo, le date vengono spostate indietro nel tempo.

• Il parametro interval è un'enumerazione. I valori validi sono DAY, MONTH, QUARTER e YEAR. Trattandosi di un'enumerazione, i valori non vengono passati come stringhe. Evitare quindi di racchiuderli tra virgolette.

• La tabella restituita può contenere solo date archiviate nella colonna dates. Ad esempio, se la colonna dates inizia dal 1° luglio 2017 e il valore start_date è 1 luglio 2016, la tabella restituita inizierà dal 1° luglio 2017.

• Questa funzione non è supportata per l'uso nella modalità DirectQuery se usata in colonne calcolate o nelle regole di sicurezza a livello di riga.

Esempio

La definizione della misura di tabella Sales seguente usa la funzione DATESINPERIOD per calcolare i ricavi per l'anno precedente (PY).

Si noti che la formula usa la funzione MAX. Questa funzione restituisce la data più recente inclusa nel contesto del filtro. La funzione DATESINPERIOD restituisce quindi una tabella di date a partire dalla data più recente per l'anno precedente.

Gli esempi in questo articolo possono essere usati con il modello campione di Adventure Works DW 2020 di Power BI Desktop. Per ottenere il modello, vedere modello campione DAX.

Revenue PY =
CALCULATE(
    SUM(Sales[Sales Amount]),
    DATESINPERIOD(
        'Date'[Date],
        MAX('Date'[Date]),
        -1,
        YEAR
    )
)

Si supponga che il report sia filtrato in base al mese di giugno 2020. La funzione MAX restituisce il 30 giugno 2020. La funzione DATESINPERIOD restituisce quindi l'intervallo di date dal 1° luglio 2019 al 30 giugno 2020. Si tratta di un anno di valori di data a partire dal 30 giugno 2020 per l'anno precedente.

Contenuto correlato

Funzioni di Business Intelligence per le gerarchie temporali (DAX)
Funzioni di data e ora (DAX)
Funzione DATESBETWEEN (DAX)