DATEADD
gäller för:beräknad kolumn
beräknad tabell
Mått
Visuell beräkning
Not
Den här funktionen rekommenderas inte för användning i visuella beräkningar eftersom den sannolikt returnerar meningslösa resultat.
Returnerar en tabell som innehåller en kolumn med datum, antingen framåt eller bakåt i tiden med det angivna antalet intervall från datumen i den aktuella kontexten.
Syntax
DATEADD(<dates>,<number_of_intervals>,<interval>)
Parametrar
Term | Definition |
---|---|
dates |
En kolumn som innehåller datum. |
number_of_intervals |
Ett heltal som anger antalet intervall som ska läggas till i eller subtrahera från datumen. |
interval |
Intervallet som datumen ska flyttas med. Värdet för intervall kan vara något av följande: year , quarter , month , day |
Returvärde
En tabell som innehåller en enda kolumn med datumvärden.
Anmärkningar
Argumentet dates
kan vara något av följande:
En referens till en datum/tid-kolumn,
Ett tabelluttryck som returnerar en enda kolumn med datum-/tidsvärden.
Ett booleskt uttryck som definierar en tabell med en kolumn med datum-/tidsvärden.
Not
Begränsningar för booleska uttryck beskrivs i avsnittet CALCULATE funktion.
Om talet som anges för
number_of_intervals
är positivt flyttas datumen idates
framåt i tiden. Om talet är negativt flyttas datumen idates
tillbaka i tiden.Parametern
interval
är en uppräkning, inte en uppsättning strängar. därför bör värden inte omges av citattecken. Dessutom ska värdena:year
,quarter
,month
,day
stavas i sin helhet när du använder dem.Resultattabellen innehåller endast datum som finns i kolumnen
dates
.Om datumen i den aktuella kontexten inte utgör ett sammanhängande intervall returnerar funktionen ett fel.
Den här funktionen stöds inte för användning i DirectQuery-läge när den används i beräknade kolumner eller säkerhetsregler på radnivå (RLS).
Exempel – Flytta en uppsättning datum
Följande formel beräknar datum som är ett år före datumen i den aktuella kontexten.
= DATEADD(DateTime[DateKey],-1,year)