Compartir a través de


STARTOFYEAR

Se aplica a:columna Calculadatabla calculadaMedidacálculo visual

Nota:

No se recomienda usar esta función en cálculos visuales, ya que es probable que devuelva resultados sin sentido.

Para la entrada de columna de fecha, devuelve la primera fecha del año en el contexto actual de la columna de fechas especificada.
Para la entrada del calendario, devuelve una tabla para la primera fecha del año, en el contexto actual. La tabla contiene todas las columnas etiquetadas principal y todas las columnas relacionadas con el tiempo.

Sintaxis

STARTOFYEAR(<dates> or <calendar>)

Parámetros

Término Definición
dates or calendar Columna que contiene fechas o una referencia de calendario.
YearEndDate (Opcional) Valor de fecha de finalización del año. Solo se aplica para la entrada de columna de fecha.

Valor devuelto

Para la entrada de columna de fecha, una tabla que contiene una sola columna y una sola fila con un valor de fecha.
Para la entrada del calendario, una tabla para la primera fecha del año, en el contexto actual. La tabla contiene todas las columnas etiquetadas principal y todas las columnas relacionadas con el tiempo.

Notas

  • El argumento dates puede ser cualquiera de los siguientes:

    • Referencia a una columna de fecha y hora.
    • Expresión de tabla que devuelve una sola columna de valores de fecha y hora.
    • Expresión booleana que define una tabla de una sola columna de valores de fecha y hora.
  • Las restricciones de las expresiones booleanas se describen en el tema, CALCULATE.

  • No se debe especificar el year_end_date parámetro cuando se usa un calendario.

  • Esta función no se admite para su uso en el modo DirectQuery cuando se usa en columnas calculadas o reglas de seguridad de nivel de fila (RLS).

Ejemplo

La fórmula de ejemplo siguiente crea una medida que devuelve el inicio del año para el contexto actual.

= STARTOFYEAR(DateTime[DateKey])

Ejemplo de inteligencia de tiempo basada en calendarios

La fórmula de ejemplo siguiente crea una tabla que devuelve columnas etiquetadas que corresponde al inicio del año, para el calendario fiscal.

= STARTOFYEAR(FiscalCalendar)

Funciones de inteligencia defecha y horaSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK