DATEADD

  • Článek

Platí pro:Calculated columnCalculated tableMeasureVisual calculation

Poznámka:

Tato funkce se nedoporučuje používat ve vizuálních výpočtech , protože pravděpodobně vrací nesmyslné výsledky.

Vrátí tabulku, která obsahuje sloupec kalendářních dat, posunutý dopředu nebo dozadu o zadaný počet intervalů z kalendářních dat v aktuálním kontextu.

Syntaxe

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

Parametry

Pojem definice
Data Sloupec, který obsahuje kalendářní data.
number_of_intervals Celé číslo, které určuje počet intervalů, které se mají sčítat nebo odečítat od kalendářních dat.
interval Interval, o který se mají data posunout. Hodnota intervalu může být jedna z následujících hodnot: year, quarter, , monthday

Vrácená hodnota

Tabulka obsahující jeden sloupec hodnot kalendářních dat.

Poznámky

Argument kalendářních dat může být některý z následujících:

  • Odkaz na sloupec data a času,

  • Výraz tabulky, který vrací jeden sloupec hodnot data a času,

  • Logický výraz, který definuje tabulku s jedním sloupcem hodnot data a času.

    Poznámka:

    Omezení logických výrazů jsou popsána v tématu funkce CALCULATE.

  • Pokud je číslo zadané pro number_of_intervals kladné, posunou se data v kalendářních datech dopředu. Pokud je číslo záporné, posunou se data v kalendářních datech zpět v čase.

  • Parametr intervalu je výčet, nikoli sada řetězců, proto by hodnoty neměly být uzavřeny do uvozovek. Také hodnoty: year, quarter, monthday by měly být při jejich použití zadány v plném rozsahu.

  • Výsledná tabulka obsahuje pouze kalendářní data, která existují ve sloupci kalendářních dat .

  • Pokud kalendářní data v aktuálním kontextu neformují souvislý interval, vrátí funkce chybu.

  • Tato funkce není podporována pro použití v režimu DirectQuery při použití v počítaných sloupcích nebo pravidlech zabezpečení na úrovni řádků (RLS).

Příklad – posun sady kalendářních dat

Následující vzorec vypočítá kalendářní data, která jsou jeden rok před kalendářními daty v aktuálním kontextu.

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

Související obsah

Funkce časového měřítka
Funkce pro datum a čas