STARTOFYEAR

Si applica a:colonna calcolatatabella calcolata calcolo visivomisura

Nota

Questa funzione è sconsigliata per l'uso nei calcoli visivi perché probabilmente restituisce risultati senza significato.

Per l'input della colonna data, restituisce la prima data dell'anno nel contesto corrente per la colonna specificata di date.
Per l'input del calendario, restituisce una tabella per la prima data dell'anno, nel contesto corrente. La tabella contiene tutte le colonne con tag primarie e tutte le colonne correlate all'ora.

Sintassi

STARTOFYEAR(<dates> or <calendar>)

Parametri

Termine	Definizione
dates or calendar	Colonna contenente date o riferimenti al calendario.
YearEndDate	(Facoltativo) Valore della data di fine dell'anno. Si applica solo per l'input della colonna data.

Valore restituito

Per l'input della colonna data, una tabella contenente una singola colonna e una singola riga con un valore di data.
Per l'input del calendario, una tabella per la prima data dell'anno, nel contesto corrente. La tabella contiene tutte le colonne con tag primarie e tutte le colonne correlate all'ora.

Osservazioni:

• L'argomento dates può essere uno dei seguenti:

  • Riferimento a una colonna di data/ora.
  • Espressione di tabella che restituisce una singola colonna di valori di data/ora.
  • Espressione booleana che definisce una tabella a colonna singola di valori di data/ora.

• I vincoli sulle espressioni booleane sono descritti nell'argomento CALCULATE.

• Il year_end_date parametro non deve essere specificato quando viene utilizzato un calendario.

• Questa funzione non è supportata per l'uso in modalità DirectQuery quando viene usata nelle colonne calcolate o nelle regole di sicurezza a livello di riga.

Esempio

La formula di esempio seguente crea una misura che restituisce l'inizio dell'anno per il contesto corrente.

= STARTOFYEAR(DateTime[DateKey])

Esempio di Business Intelligence per le gerarchie temporali basate su calendario

La formula di esempio seguente crea una tabella che restituisce colonne contrassegnate che corrispondono all'inizio dell'anno, per il calendario fiscale.

= STARTOFYEAR(FiscalCalendar)

Contenuto correlato

Funzioni di Business Intelligence per le gerarchie temporali e di data e oraSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK