DATEADD

  • Artikel

Van toepassing op: Berekende kolomBerekende tabelMetingVisuele berekening

Notitie

Deze functie wordt afgeraden voor gebruik in visuele berekeningen omdat deze waarschijnlijk betekenisloze resultaten retourneert.

Retourneert een tabel die een kolom met datums bevat, verschoven naar voren of achteruit in de tijd met het opgegeven aantal intervallen van de datums in de huidige context.

Syntaxis

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

Parameters

Term Definitie
Datums Een kolom met datums.
number_of_intervals Een geheel getal dat het aantal intervallen aangeeft dat moet worden toegevoegd aan of afgetrokken van de datums.
interval Het interval waarmee de datums moeten worden verplaatst. De waarde voor interval kan een van de volgende zijn: year, quarter, , monthday

Retourwaarde

Een tabel met één kolom met datumwaarden.

Opmerkingen

Het argument datums kan een van de volgende zijn:

  • Een verwijzing naar een datum-/tijdkolom,

  • Een tabelexpressie die één kolom met datum-/tijdwaarden retourneert,

  • Een Boole-expressie die een tabel met één kolom met datum-/tijdwaarden definieert.

    Notitie

    Beperkingen voor Boole-expressies worden beschreven in het onderwerp CALCULATE, de functie CALCULATE.

  • Als het getal dat is opgegeven voor number_of_intervals positief is, worden de datums in datums naar voren verplaatst. Als het getal negatief is, worden de datums in datums terug in de tijd verschoven.

  • De intervalparameter is een opsomming, geen reeks tekenreeksen. Daarom mogen waarden niet tussen aanhalingstekens worden geplaatst. Ook moeten de waarden: year, quarter, month, volledig day worden gespeld wanneer ze worden gebruikt.

  • De resultatentabel bevat alleen datums die aanwezig zijn in de datumkolom .

  • Als de datums in de huidige context geen aaneengesloten interval vormen, retourneert de functie een fout.

  • Deze functie wordt niet ondersteund voor gebruik in de DirectQuery-modus wanneer deze wordt gebruikt in regels voor beveiliging op rijniveau (berekende kolommen of beveiliging op rijniveau).

Voorbeeld: een set datums verschuiven

Met de volgende formule worden datums berekend die één jaar vóór de datums in de huidige context staan.

= DATEADD(DateTime[DateKey],-1,year)

Gerelateerde inhoud

Time intelligence-functies
Datum- en tijdfuncties