STARTOFYEAR

gäller för:beräknad kolumnberäknad tabellMåttVisuell beräkning

Kommentar

Den här funktionen rekommenderas inte för användning i visuella beräkningar eftersom den sannolikt returnerar meningslösa resultat.

För datumkolumnindata returnerar det första datumet på året i den aktuella kontexten för den angivna kolumnen med datum.
För kalenderindata returnerar en tabell för det första datumet på året i den aktuella kontexten. Tabellen innehåller alla primära taggade kolumner och alla tidsrelaterade kolumner.

Syntax

STARTOFYEAR(<dates> or <calendar>)

Parametrar

Period Definition
dates or calendar En kolumn som innehåller datum eller en kalenderreferens.
YearEndDate (Valfritt) Ett värde för årets slutdatum. Gäller endast för datumkolumnindata.

Returvärde

För datumkolumnindata, en tabell som innehåller en enda kolumn och en enskild rad med ett datumvärde.
För kalenderindata, en tabell för det första datumet på året, i den aktuella kontexten. Tabellen innehåller alla primära taggade kolumner och alla tidsrelaterade kolumner.

Kommentarer

  • 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.
  • Begränsningar för booleska uttryck beskrivs i avsnittet CALCULATE.

  • Parametern year_end_date får inte anges när en kalender används.

  • 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

Följande exempelformel skapar ett mått som returnerar årets start för den aktuella kontexten.

= STARTOFYEAR(DateTime[DateKey])

Exempel på kalenderbaserad tidsinformation

Följande exempelformel skapar en tabell som returnerar taggade kolumner som motsvarar början av året för räkenskapskalendern.

= STARTOFYEAR(FiscalCalendar)

Datum- och tidsfunktionerTidsinformationsfunktionerSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK