Partager via


STARTOFYEAR

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Remarque

L’utilisation de cette fonction est déconseillée dans les calculs visuels, car elle est susceptible de retourner des résultats non pertinents.

Pour l’entrée de colonne de date, retourne la première date de l’année dans le contexte actuel de la colonne spécifiée de dates.
Pour l’entrée de calendrier, retourne une table pour la première date de l’année, dans le contexte actuel. La table contient toutes les colonnes marquées principales et toutes les colonnes associées à l’heure.

Syntaxe

STARTOFYEAR(<dates> or <calendar>)

Paramètres

Terme Définition
dates or calendar Colonne qui contient des dates ou une référence de calendrier.
YearEndDate (Facultatif) Valeur de date de fin d’année. S’applique uniquement à l’entrée de colonne de date.

Valeur de retour

Pour l’entrée de colonne de date, une table contenant une seule colonne et une seule ligne avec une valeur de date.
Pour les entrées de calendrier, une table pour la première date de l’année, dans le contexte actuel. La table contient toutes les colonnes marquées principales et toutes les colonnes associées à l’heure.

Remarques

  • L’argument dates peut être l’un des éléments suivants :

    • Référence à une colonne de date/heure.
    • Expression de table qui retourne une seule colonne de valeurs de date/heure.
    • Expression booléenne qui définit une table à colonne unique de valeurs de date/heure.
  • Les contraintes sur les expressions booléennes sont décrites dans la rubrique CALCULATE.

  • Le year_end_date paramètre ne doit pas être spécifié lorsqu’un calendrier est utilisé.

  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).

Exemple

L’exemple de formule suivant crée une mesure qui retourne le début de l’année pour le contexte actuel.

= STARTOFYEAR(DateTime[DateKey])

Exemple pour l’intelligence temporelle basée sur le calendrier

L’exemple de formule suivant crée une table qui retourne des colonnes marquées correspondant au début de l’année, pour le calendrier fiscal.

= STARTOFYEAR(FiscalCalendar)

Fonctions Time Intelligence de date et d’heureSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK