Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
s’applique à :
colonne calculée
table calculée
mesure
calcul 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
datespeut ê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_dateparamè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)
Contenu connexe
Fonctions Time Intelligence de date et d’heureSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK